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the ICESat (Ice, Cloud and Land Elevation Satellite) laser altimetry mission. ICESat was the 
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tion Volume. 
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Section 1 

Introduction 


1.1 Identification of Document 

This document is identified as the GLAS Science Algorithm Software (GSAS) User’s Guide. 
This is the final release of this document. 

1.2 Scope of Document 

The I-S1PS Data Processing System, shown in Figure 1-1, provides data processing and mis- 
sion support for the Geoscience Laser Altimeter System (GLAS). 1-SIPS is composed of two 
major software components - the GLAS Science Algorithm Software (GSAS) and the Sched- 
uling and Data Management System (SDMS). GSAS processes raw satellite data and creates 
EOS Level 1 A/B and 2 data products. SDMS provides for scheduling of processing and the 
ingest, staging, archiving and cataloging of associated data fdes. This document is the User’s 
Guide for the GSAS component. 
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1.3 Purpose and Objectives of Document 

The purpose of this document is to provide the GSAS end users with instructions explaining 
how to operate the software effectively. 

1.4 Document Organization 

This document's outline is assembled in a form similar to those presented in the NASA Soft- 
ware Engineering Program [Information Document 2.3a]. 

1.5 Document Change History 


Table 1-1 Document Change History 


Document Name: GLAS Science Algorithm Software Users’ Guide 

Version Number 

Date 

Nature of Change 

Version 0 

August 1999 

Original Version. 

Version 1 

November 2000 

Revised for VI software. 

Version 2 

November 2001 

Revised for V2 software. 

Version 2.2 

July 2002 

Revised for V2.1 and 2.2 software. 

Version 4.0 

October 2002 

Revised for V3.0 software. 

Version 5.0 

August 2004 

Revised for V4.0 software. 

Version 6.0 

March 2006 

Revised for V5.0 software. 

Version 7.0 

August 2012 

Revised for V6.0.1 software 
Final edition. 
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Section 2 

Related Documentation 


2.1 Parent Documents 

Parent documents are those external, higher-level documents that contribute information to 
the scope and content of this document. The following GLAS documents are parent to this 
document. 

a) GLAS Science Software Management Plan (GLAS SSMP), August 1998, NASA/ 
GSFC Wallops Flight Facility, NASA/TM- 1999-20864 1/Version 3/Volume 1. 

b) . Data Production Software and Science Computing Facility (SCF) Standards and 
Guidelines, 423-16-01, January 14, 1994, Goddard Space Flight Center. 

2.2 Applicable Documents 

Applicable documents include reference documents that are not parent documents. This cate- 
gory includes reference documents that have direct applicability to, or contain policies bind- 
ing upon, or information directing or dictating the content of this document. The following 
GLAS, EOS Project, NASA, or other Agency documents are cited as applicable to this docu- 
ment. 

a) NASA Software Documentation Standard Software Engineering Program, NASA- 
STD-2 100-91, July 29, 1991, NASA. 

b) GLAS Science Algorithm Software (GSAS) Detailed Design Document (GSAS DD), 
Version 6.0, August 2012, NASA Goddard Space Flight Center. 

c) GLAS Science Algorithm Software (GSAS) Version Description Document (GSAS 
VDD), Version 6.0, February 2012, NASA Goddard Space Flight Center. 

2.3 Information Documents 

The following documents are provided as sources of information that provide background or 
supplemental information that may clarify or amplify material presented in this document. 

a) The Algorithm Theoretical Basis Document for Level 1A Processing, NASA/TM- 
2012-208641 / Volume 5, June 2012, NASA Goddard Space Flight Center, et al. 

b) The Algorithm Theoretical Basis Document for the GLAS Atmospheric Data Products, 
NASA/TM-20 12-208641 / Volume 6, July 2012, NASA Goddard Space Flight Center, 
et al. 

c) The Algorithm Theoretical Basis Document for the Derivation of Range and Range 
Distributions from Laser Pulse Waveform Analysis for Surface Elevations, Roughness, 
Slope, and Vegetation Heights, NASA/TM-20 12-20864 1/Volume 7, August 2012, 
NASA Goddard Space Flight Center, et al. 
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d) The Algorithm Theoretical Basis Document for the Atmospheric Delay Correction to 
GLAS Laser Altimeter Ranges, NASA/TM-20 12-20864 1/Volume 8, NASA Goddard 
Space Flight Center, et al. 

e) The Algorithm Theoretical Basis Document for Tidal Corrections, NASA/TM-20 12- 
208641/Volume 9, Scripps Institution for Oceanography, et al. 

f) The Algorithm Theoretical Basis Document for Precision Orbit Determination, 2012, 
University of Texas Center for Space Research, et al. 

g) The Algorithm Theoretical Basis Document for Precision Attitude Determination, 
2012, University of Texas Center for Space Research, et al. 

h) The Algorithm Theoretical Basis Document for Laser Footprint Location ( Geoloca- 
tion) and Surface Profiles, 2012, University of Texas Center for Space Research, et al. 

i) GLAS Standard Data Products Specification - Level 1, NASA/TM-20 13-20864 1/Vol- 
ume 13, NASA Goddard Space Flight Center, et al. 

j) GLAS Standard Data Products Specification - Level 2, NASA/TM-20 13-20864 1/Vol- 
ume 14, NASA Goddard Space Flight Center, et al. 

k) GLAS Standard Data Products Specification - Data Dictionary, NASA/TM-20 13- 
20864 1/Volume 15, NASA Goddard Space Flight Center, et al. 

l) GLAS Science Algorithm Software (GSAS) Detailed Design, NASA/TM-20 13- 
208641/Volume 16, NASA Goddard Space Flight Center, et al. 
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Section 3 

Overview 


3.1 Purpose 

GSAS generates the GLAS Standard Data Products and associated metadata describing the 
products and their quality. The software uses GLAS telemetry and ancillary data to produce 
the products using algorithms defined by the GLAS Instrument and Science Teams. 

GSAS is delivered as a set of libraries and PGEs (Product Generation Executables). A PGE is 
an executable program which performs a specific function. The ‘core’ PGEs perform specific 
portions of the GLAS data processing and generate deliverable GLAS Data Products (Prod- 
ucts). The core PGEs are accompanied by a set of utility PGEs which perform such functions 
as creating ancillary data files, perfonning quality assurance and generating browse products. 

Throughout this document, files are referenced as one of two types: GLA or ANC. GLA files 
are fixed-length, integer-binary format product files containing Level 0-2 GLAS science data. 
Level 3 science data is provided with the planned HDF-EOS formatted GLA 16 (never pro- 
duced/distributed). GLA files are both input and output to GSAS. ANC files are multi-format 
ancillary files which are required for processing. A list of the GLA and ANC files is supplied 
in Appendix A. The GLAS Standard Data Product files (GLA) are detailed in the GLAS Sci- 
ence Data Management Plan, the GLAS Standard Data Products Specification - Level 1 and 
the GLAS Standard Data Products Specification - Level 2. 

3.2 Environment 

GSAS was originally developed in a HP/UX environment, but was ported to and now deliv- 
ered on Linux. This document assumes that the reader is familiar Linux conventions. The soft- 
ware is currently developed, tested and supported on Ubuntu 10.04.4 LTS with g95 0.92 and 
IDL 8.0. 

3.3 Functions 

The functionality of the PGEs is grouped into four major categories: LI A processing, Altime- 
try processing, Atmosphere processing, and utility functions. 

L1A processing uses Level-0 data and L1A science algorithms to create Level-IA products 
(GLA01-04). 

Altimetry processing uses L1A data and waveform/elevation science algorithms to create 
Level-IB waveform (GLA05) and Level-lB/2 elevation (GLA06, GLA11-15) products. 

Atmosphere processing uses LI A data and atmosphere science algorithms to create Level 1-B 
and 2 (GLA07-1 1) atmosphere products. 

The utilities perfonn functions which are ancillary to the main data processing process. This 
includes such tasks as data reformatting, ancillary file creation, browse product creation, and 
data validation. 


March 2013 


Page 3-1 


Version 7.0 



The GLAS Science Algorithm Software (GSAS) User’s Guide 


Overview 


In order to perform these functions, PGEs are designed to reflect a natural division in GLAS 
data processing. Table 3-1 lists the name, category, and function of each of these executables. 


Table 3-1 GSAS PGEs 


PGE 

Category 

Functionality 

GLAS_L0proc 

Utility 

Creates an ancillary file from Level-0 APIDs which contains 
timing and data alignment information. 

GLAS_L1 A 

L1A 

Reads the GLAS_L0proc ancillary file and associated APID 
files to create Level-IA GLAS data. 

GLAS_Alt 

Altimetry 

Reads altimetry-related Level-IA data files and ancillary 
files to create Level-1 B and 2 GLAS altimetry files. 

GLAS_Atm 

Atmosphere 

Reads atmosphere-related Level-1 A data files and ancillary 
files to create Levellb and 2 GLAS atmosphere files. 

GLAS_Reader 

Utility 

Non-Production. Reads specified GSAS ancillary and/or 
product files and creates a text-based, human-readable 
representation of the data. 

GLAS_Meta 

Utility 

Reads specified product files and creates EOS-compliant 
metadata inventory files. 

GLASGPS 

Utility 

Non-Production. Uses the externally-supplied RINEX soft- 
ware to process GPS data, (this utility was developed 
before UTexas assumed the GPS processing role.) 

GLASAPID 

Utility 

Non-Production. Reads APID files and creates column- 
based text output suitable for importing into spreadsheets. 

GLAS_Tick 

Utility 

Reads GLA03 and ANC32 files to create ANC50 files con- 
taining engineering statistics and GPS update event data 

atm_anc 

Utility 

Reads atmosphere Level-1 products and creates atmo- 
sphere calibration files. 

met_util 

Utility 

Reads and subsets standard Meteorological files, creating 
GSAS ancillary MET files. 

reforbit_util 

Utility 

Reads Reference Orbit files to create ascending equatorial 
crossings. 

createGran_util 

Utility 

Reads Predicted Orbit files, creating all ascending equato- 
rial crossings, and +/- 50 degree latitude crossings. 

create regionsMA 
SKutil 

Utility 

Creates fine and coarse surface type grid files from the 
masks files. 

QAbrowse 

IDL Utility 

Creates graphical browse products from product QA files. 

qapg 

Utility 

Creates comparative CAP files for GLA product files. 

NOSE_util 

Utility 

Creates a output file containing NOSE off-nadir track and 
segment coordinates for ESDIS and track and segment 
numbers for GLAS product headers and metadata. 
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Table 3-1 GSAS PGEs (Continued) 


PGE 

Category 

Functionality 

produtil 

Utility 

Non-Production. A collection of utilities which provide such 
functions as writing sample product files for testing pur- 
poses (product_test), subsetting GLA00 APIDs (stripper), 
providing ESDIS-deliverable sample product readers 
(gsas_prod_readers), read and write the decompressed 
waveform in volts (process_wf), and stripping extraneous 
information from spacecraft-test 1984 APID data 
(stripl 984). 

QACompare 

Utility 

Generates product-specific QA parameters to allow data 
quality assessment, and QA flags for inclusion in the meta- 
data. 


The GSAS design allows a significant amount of commonality among the executables. This is 
beneficial from both a software maintenance and ease-of-use point of view. Common func- 
tionalities include: 

• Use of a control file for dynamic processing information. 

• Ability to perform partial processing. 

• Ability to perfonn selective processing based on input and output time specification. 

• Use of change-controlled ancillary files which contain changeable Science Team-sup- 
plied parameters. 

• Input data time synchronization 

• Creation of metadata which contains a full processing history. 

• Use of a standardized error/message reporting facility with user-defined options avail- 
able. 

3.4 Time Specification 

All GSAS times are specified in J2000 UTC, with an epoch of January 1, 2000 12:00:00. In 
some cases, GPS times are used internally, but are converted to J2000 UTC before presenta- 
tion to the user in order to preserve consistency. All user-interaction with GSAS requires time 
specifications in J2000 UTC. 

3.5 Restrictions and Limitations 

GSAS has the following limitations: 

• GSAS is supported on Ubuntu 10.04.4 with g95 0.92and IDL 8.0. 

Refer to the latest version of the GSAS Version Description document for additional informa- 
tion. 
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Section 4 

Installation and Initialization 


This section will detail installation instructions for GSAS. This version of GSAS has only 
been tested under Ubuntu 10.04.4. (However, it should compile on our previous development 
platform (HP/UX 11.0/F90 2.5.10). These instructions are for a local source-only installation 
of GSAS. For the latest compilation and installation notes, refer to the GSAS Version Descrip- 
tion document which describes installing the full DAP along with requisite data files and test 
cases. 

Note: Throughout this document, the text refers to directory names preceded by a “$” and 
typed in all capital letters. This means that the directory path is local to the specific installation 
and not hard-coded within the GSAS. (This document uses standard UNIX ‘sh’ variable con- 
ventions to indicate such.) Other pathnames are specified relative to the local directories and 
only the relative relationship is important. 

4.1 Unpack the Tarfile 

Create a production directory for GSAS. This directory is designated $GLAS_HOME. 
mkdir $GLAS_HOME 

Copy the delivered tar file into GLAS HOME and untar it. We will refer to the tar file as 
‘gsas.tar’, but the actual delivery file may be named differently. Designate $DIST_DIR as the 
source of the gsas.tar tarfile. 

cd $GLAS_HOME 
cp $DIST_DIR/gsas.tar. 
tar xf gsas.tar 

The untar process will create the directory structure described in Table 4- 1 . 


Table 4-1 GSAS Directory Structure 


Directory 

Description 

$GLAS_HOME/bin 

GSAS executables. Executables should always be linked from this 
directory. 

$GLAS_HOME/lib 

GSAS shared libraries. (The user should always set the SHLIB PATH 
environmental variable to this directory or link the libraries from this 
directory into the working directory.) 

$GLAS_HOME/cc_util 

Contains makefile utilities. 

$GLAS_HOME/idl 

Contains IDL code. 

$GLAS_HOME/docs 

Contains PDF versions of released documents. 

$GLAS_HOME/data 

Contains sample control and ancillary files. 
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Table 4-1 GSAS Directory Structure (Continued) 


Directory 

Description 

$GLAS_HOME/src 

Contains Fortran90 anc C source code. 

$GLAS_HOME/test 

Contains test data and scripts to verify proper operation of the software. 


4.2 Compilation 

Change to the production directory and perfonn the following makes: 

cd $GLAS_HOME 
make clean 
make runtime 
make install 

After this process is complete, all object files, libraries, and executables will have been re-cre- 
ated and installed in the appropriate directories. This is the recommended mode of compila- 
tion. It is the method used to create the distribution binaries and for final integration and 
acceptance testing. 

4.2.1 Debugging 

The debug option signals that the compiler should produce code which performs bounds 
checking, floating point exception checking, runtime error trapping and allows for use of a 
symbolic debugger. 

If debug checking is desired, the software must be recompiled with the “debug” flag. 

cd $GLAS_HOME 
make clean 
make debug 
make install 

After this process is complete, all object files, libraries, and executables will have been re-cre- 
ated with the debug option and installed in the appropriate directories. 

4.2.2 Optimization 

The optimization option signals that the compiler should produce optimized code. These opti- 
mizations include such things as full level-3 optimization, automatic parallelization, array 
reordering, and subroutine inlining. Note that compiling with optimization takes a significant 
amount of time. Given that optimization is a “risky” process, refer to the appropriate version 
of the GSAS Version Description Document for additional infonnation. 

If optimization is desired, the software must be recompiled with the “fast” flag. 

cd $GLAS_HOME 
make clean 
make fast 
make install 
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After this process is complete, all object files, libraries, and executables will have been re-cre- 
ated, optimized with the “fast” option and installed in the appropriate directories. 

4.3 Verification 

GSAS includes a suite of data and scripts to verify proper operation of the software. This suite 
is a subset of the GSAS Acceptance test. The test runs each of the GSAS PGEs with approxi- 
mately 600 seconds of test data. The test should take less than 20 minutes to complete. 

Assuming the software has been successfully compiled and installed, verify its operation as 
follows: 

cd $GLAS_HOME/test 
./verify.sh 

The following shows a successful verification test. Contact the GSAS development team if 
your results differ 

GSAS Verification Test 

Cleaning up... 

Testing GLAS LOproc... 

Passed. 

Testing GLAS L1A... 

Passed. 

Testing reforbit util... 

Passed. 

CreateGranutil. . . 

Passed 

Testing metutil... 

Passed. 

Testing atmanc... 

Passed. 

Testing GLASAtm... 

Passed. 

Testing GLAS_Alt (Waveforms)... 

Passed. 

Testing GLAS_Alt (Elevation)... 

Passed. 
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After successful completion, the newly created data may be removed by running the following 
command: 

cd $GLAS_HOME/test 
./cleanup, sh 
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Section 5 

Common Functionality 


GSAS code was designed to maximize software reuse capabilities. As such, it provides for a 
great deal of common functionality among its PGEs. GSAS uses standardized control files, 
constants files, and error/status reporting facilities. This makes GSAS easier to use since, for 
example, a control file for one PGE is basically the same style as a control file for other PGEs. 

5.1 Control Files 

Control files are the interface between GSAS and the user (or controlling process). Control 
files provide dynamic control infonnation to PGEs. Static infonnation is provided by ancillary 
constants files (ANC07). A single control file can provide instructions for more than one 
PGE. Section breaks are used to delimit those instructions of significance to the specific PGE. 

5.1.1 Use 

The name of the control file is passed as a command-line argument during each invocation of 
the PGE. Most PGEs will tenninate with a fatal error if the command-line argument is miss- 
ing, the specified file does not exist, or the file is unreadable. The exceptions to this rule are 
GLAS Reader and GLAS APID, which provide a rudimentary user-interface when invoked 
without a control file name. 

5.1.2 Format 

GSAS control files are designed to be part of a larger control file used by one or more PGE. 
As such, it specifies sections that identify the PGE that will perform the task requiring the 
inputs contained in the section. Each section is bounded by an "=" sign in column 1, followed 
by the PGE name that requires the control inputs. Exact section names will be shown in the 
PGE-specific control file section of this document. 

All GSAS control files are created in standard GSAS “keyword=value” format. This format is 
text-based and consists of a line containing a keyword/value pair delimited by an equal sign 
(=). The ordering of the keywords is not relevant but should follow a convention for consis- 
tency. Multiple instances of certain keywords are allowed. The keyword is not case sensitive. 
Spaces are allowed, but not required. Comment lines must be prepended by a “#” character. 
The keyword and value are limited to 255 characters each. 

5.1.3 Content 

PGE sections within a control file contain both common and process-specific information. 
The process-specific portions of control files will be provided within the documentation for 
each specific executable. This section will document common elements of the PGE control 
files 

Within a control file section, some information is required, other is optional. As shown in 
Table 5-1, required single-instance keywords include: 
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Optional multiple-instance keywords, as shown in Table 5-2, include.: 


Table 5-1 

Required Single-Instance Keywords 

Keyword 

Value 

TEMPLATE_NAME= 

Name of the control file template. 

EXEC_KEY= 

Unique (per day) execution key 

DATE_GENERATED= 

Date the control file was generated. 

OPERATOR= 

Operator who generated the control file. 

PGE_VERSION= 

External Version number of the target PGE. 

Table 5-2 

Optional Multiple-Instance Keywords 

Keyword 

Value 

PASSID= 

Pass-related information 

INPUT_FILE= 

Input filename and associated information 

OUTPUT_FILE= 

Output filename and associated information 

WRITE_CONST= 

Signals that the specified constants should be written to ANC06. 
(described in Section 5.3.3.) 

5.1.4 PASSID Specification 

A PASSID section is required in 

the control file when creating GLA products. There should 


be one instance of the following keyword/values for all tracks which fall within the minimum/ 
maximum time of the data being processed. This information is required for GLAS L1A, 
GLAS Alt, and GLASAtm. This infonnation is NOT required for GLAS LOproc or other 
utilities. 

In the final version of GSAS (6.0.1) the nose_path_number is not used 
PASSID=revolution_num<sp>pas- 

sid<sp>start_time<sp>stop_time<sp>equator_crossing_lon<sp>no 
se_path_number . 
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Descriptions of the PAS SID elements are provided in Table 5-3. 


Table 5-3 PASSID Control Line Elements 


Element 

Description 

revolution_num 

integer, containing the auto-incrementing rev number. 

passid 

11-byte character, further described below. 

start_time 

double-precision float, containing J2000 UTC time in seconds. 

stop_time 

double-precision float, containing J2000 UTC time in seconds. 

equator_crossing_lon 

float, containing the equator crossing longitude. 

nose_path_number 

integer, containing the NOSE path number. 


The eleven-byte passid field will be treated as follows: prkkccctttt. Descriptions of each ele- 
ment are provided in Table 5-4. 


Table 5-4 passid Field Description 


Field 

Description 

P 

repeat ground track phase (integer, length=1) 

r 

reference orbit number (integer, length=1) 

kk 

instance (integer, length=2) 

ccc 

cycle (integer, length=3) 

tttt 

track (integer, length=4) 


Example (with nonsense values): 


# 

# Pass ID Information 

# 


PASSID=107 

11010010001 

85300 . 0 

85350 . 0 

35 . 0 

37 

PASSID=108 

11010010001 

85351.0 

85400 . 0 

45 . 0 

38 

PASSID=109 

11010010002 

85401.0 

85500 . 0 

55 . 0 

39 

PASSID=110 

12010010003 

85501.0 

85600 . 0 

65 . 0 

40 

PASSID=111 

12010010004 

85601.0 

85700 . 0 

75 . 0 

41 

PASSID=112 

22010010005 

85701.0 

85800 . 0 

85 . 0 

42 

PASSID=113 

22010020006 

85851.0 

85900 . 0 

95 . 0 

43 

PASSID=114 

22020020007 

85901.0 

86000 . 0 

105 . 

0 44 

PASSID=115 

22020020007 

86001.0 

86500 . 0 

115 . 

0 45 


5.1.5 Input/Output File Specification 

Input and Output files are required to be designated using the GSAS-standard naming conven- 
tion defined in Appendix A. The type of each file specified is determined by parsing specific 
components of the filename which are required by all of the naming methods defined in the 
specification. These common components of all filenames are: 

HHHxx mmm. . . ffff .eee 
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(where: HHH is the type identification, xx is the type id number, mmm is the release number, 
tfi is the file sub-type, and eee is the file extension.) 

GSAS software uses the type identification, the type id number and the file sub-type to deter- 
mine what type of file is specified in the control file. The filetype-parsing routines are not 
case-sensitive when detennining the type of file specified. However, the filenames are case- 
sensitive during file opening and creation. 

All files are required to be delimited by start and stop times. These times are floating point 
values specified on the control line as J2000 time in seconds. On both input and output, 
records are skipped until the time in the current record is greater than or equal to the specified 
start-time and less than or equal to the specified stop-time. Static ancillary files are required to 
have start-times and stop-times present for consistency, but these are currently ignored. 

The minimum required formats for input and output file specifications are: 

INPUT_FILE= f i le_name< sp>s tart_t ime< sp>stop_t ime 
OUTPUT_FILE=f ile_name<sp>start_time<sp>stop_time 

Additionally, GLA product file entries should contain segment and version information. This 
information is specified in the format: 

INPUT_FILE=f ile_name<sp>start_time<sp>stop_time<sp>gran_rel_ 
num< sp >gran_ve r_num< sp >gran_segment 

OUTPUT_FILE=f ile_name<sp>start_time<sp>stop_time<sp>gran_rel 
_num< sp >gran_ve r_num< sp >gran_segment 

Segment and version information fields are described in Table 5-5. 


Table 5-5 File Segment and Version Fields 


Field 

Description 

gran_rel_num 

granule release number (CCB controlled, mmm in filenaming convention.) 
Character max length of 20. 

gran_ver_num 

granule version number (Auto-incrementing, nn in filenaming convention). 
Character max length of 20. 

gran_segment 

orbit segment of the granule (if more that 1 segment, use 0). Character 
max length of 1. 


Files with INPUTFILE and OUTPUTFILE keywords must be listed in chronological order 
based on start and stop times. The start time of one file may overlap the stop time of another. 
In this case, data within the overlapping range will be written to the first file and not the sec- 
ond. 

Example of a GLA file specification control line: 

OUTPUT_FILE=glaO 1_0 0 2_1 1_0 0 0 1_0 04 3_4_0 0_0 0 0 0. dat 85398 86000 1 1 0 
OUTPUT_FILE=gla02_002_ll_0001_0043_0_00_0000 . dat 85398 86000 110 

Example of an ANC file specification control line: 
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INPUT_FILE=anc07_001_01_0000 . dat 85398 86000 
INPUT_FILE=anc07_001_01_0001 . dat 85398 86000 

5.1.6 Example Control File 

Following is a partial control file which highlights elements common to all GSAS control 
files. Examples of specific control files will be provided within the documentation for each 
specific PGE. 

# Start of Control File 

# 

# description of control file> 

# 

# Execution Information 

# 

=GLAS_L1A 

TEMPLATE=< template name> 

EXEC_KEY=<unique execution key> 

DATE_GENERATED=<date/time control file was generated> 

OPERATOR=<operator name/uid> 

PGE_VERSION=<PGE version number> 

# 

# Static ANC Files 

# 

# Common Input ANC07 Files: 00=error, 01=global 

# 

INPUT_FILE=<anc0700_error filename starttime stoptime> 
INPUT_FILE=<anc0701_global_f ilename starttime stoptime> 

# 

# Output ANC06 File 

# 

# Output ANC06 

# 

OUTPUT_FILE=<anc06_f ilename starttime stoptime> 

{processing scenario-specific elements} 

# 

# End of Control File 

# 

=End of Control File 

5.2 Processing Controls 

The core PGEs (GLAS L1A, GLAS Atm, GLAS Alt) provide for flexible methods of pro- 
cessing GLAS data. All controls are specified via the control file. Methods of controlling data 
processing include: 

• Input data time selection 

• Output data time selection 

• Execution control 
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The detailed documentation for each PGE will identify what respective types of processing 
controls are available. 

5.2.1 Input Data Time Selection 

As seen in the Control File section, all input files are required to be delimited by start and stop 
times on their control file entry. PGEs which support time selection will skip that data which 
are outside the limits defined by start and stop times. This data will be read, but not processed. 
Additionally, given the case of multiple input files of the same type, the PGE will seemlessly 
move from one file to the next when all data from the current file have been read (or skipped 
via time selection). 

Certain input ancillary files do not support input time selection but require start and stop times 
in their control file entry. The recommended method of delimiting time in the case is to use the 
minimum-to-maximum range of input dynamic data time for these entries. 

5.2.2 Output Data Time Selection 

As with input files, all output files are required to be delimited by start and stop times on their 
control file entry. PGEs which support time selection will not write that data which are outside 
the limits defined by start and stop times. Additionally, given the case of multiple output files 
of the same type, the PGE will seemlessly move from one file to the next when the current 
data time falls outside the range of the current output file. It is important to note that input data 
time selection and output data time selection are completely independent of one another. 
There is, however, a practical relationship between the two, since output data for a particular 
time cannot be written if no input data for that time is read (or specified). 

5.2.3 Execution Scenarios 

Most core PGEs permit multiple execution scenarios. Certain sets of computations have been 
grouped together by the software designers. Execution of these sets can be specified via spe- 
cific execution flags with the PGE control file. The detailed documentation for each PGE 
specifies what execution flags are available and the processes they control. Additionally, there 
are dependencies between input file type, output file type, and the execution flags. These 
dependencies define execution scenarios, which will be described in the respective PGE -spe- 
cific section of this document. 

5.3 ANC07 Constants Files 

ANC07 files are used to provide GSAS with change-controlled parameters provided by the 
Science Team and used during processing of GLAS data. These are parameters that may be 
modified by science team request but are not likely to require a corresponding software 
change. By putting the parameters in the ANC07 input files, the team avoids recompiling the 
GSAS software for the parameter change. It is critical that these files are tightly change-con- 
trolled since unapproved modification could result in erroneous data being generated during 
the creation of the GLAS Products. 

There are several types of ANC07 files. These types include a global constants file, an error 
file, and constants files specific to each of the science algorithm categories. The error file is 
detailed in the error section of this document. The science-algorithm specific constants files 
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will be detailed in the respective documentation for those particular executables. This section 
will document the global constants file and the commonalities of all these files. 

5.3.1 Use 

The constants files are specified as input files within a particular executable’s control file. The 
global constants file and the error constants file are required for all executables. Table 5-6 
shows the naming convention of each ANC07 file and a description of its content, (mmm is 
the release number for process that created the file and is the version number of the file itself 
within the mmm release). 


Table 5-6 ANC07 Files 


Naming Convention 

Content 

anc07_mmm_nn_0000.dat 

Error/Status constants 

anc07_mmm_nn_0001 .dat 

Global constants 

anc07_mmm_nn_0002.dat 

Atmosphere constants 

anc07_mmm_nn_0003.dat 

Elevation constants 

anc07_mmm_nn_0004.dat 

Waveform constants 

anc07_mmm_nn_0005.dat 

LI A constants 

anc07_mmm_nn_0006.dat 

Utility constants 


5.3.2 Format 

GSAS ANC07 files are delimited by section identifiers which differ (by design) from control 
files section identifiers. Each section is bounded by the section name and an "=". The section 
delimiters are defined as follows: 

BEG_OF_STATUS= 

...Status section contents... 

END_OF_STATUS= 

BEG_OF_ERROR= 

...Error section contents... 

ENDOFERROR 

BEG_OF_GLOBALS= 

...Global constants section contents... 

END OF GLOBALS 

BEG_OF_ATM= 

...Atmosphere constants section contents... 

ENDOFATM 

BEG_OF_ELEV= 

...Elevation constants section contents... 

END OF ELEV 
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BEG_0F_L1A= 

...LI A constants section contents... 

END_0F_L1A 

All GSAS ANC07 files are created in standard GSAS “keyword=value” format. This format 
is text-based and consists of a line containing a keyword/value pair delimited by an equal sign 
(=). The ordering of the keywords is not relevant but should follow a convention for consis- 
tency. Multiple instances of keywords are not allowed. The keyword is not case sensitive. 
Spaces are allowed, but not required. Comment lines must be prepended by a “#” character. 
The keyword and value are limited to 255 characters each. 

5.3.3 ANC07 Output Options 

GSAS provides the ability to write the values of selected sets of constants into the ANC06 file 
at runtime. This is activated by a control file entry with a keyword of WRITE CONST. The 
associated value determines what set of constants should be written. Multiple 
WRITE CONST control file entries, each specifying a different set of constants, are permit- 
ted. 


Table 5-7 WRITE CONST Control Values 


Value 

Constants to Write 

ERR 

Error/Status constants. 

LI A 

L1A constants. 

WF 

Waveform constants. 

ATM 

Atmosphere constants. 

ELEV 

Elevation constants. 

GLOB 

Global constants. 


Example control file entries: 

#Dump constants to ANC06 

WRITE_CONST=GLOB 

WRITE_C0NST=L1A 

5.3.4 Global Constants File Content 

The ANC07 global constants file contains very-high level constants that are used by more 
than one PGE. A sample global constants file follows (Please use to actual ANC07 file to 
detennine values) : 

## 

# GLAS ANC07 Constants File 

# 

# 06/07/99 PL J Corrected the elevation status messages 

# 1999 September 22 JLee, Updated GLAS_Error where error < 0 

# 09/27/99 GMM Updated the error list to include entries from ATM, WF, ELEV 

# subsystems and made error codes negative. 

# 1999 October 18 JLee, Fixed error code. 

# 1999 November 01 JLee, Integrated ATM constants 
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# 2000 March 13 JLee, Updated 

# 2001 April 13 JLee, Added DEM constants from Elevation 

# 2001 May 16 PJester , Added GPS to UTC offset 

# 2001 June 08 JLee, Modified GPS to UTC offset to match Donghui ' s data 

# 2001 August 22 JLee, Moved calibration coefs from L1A to here so that 

# both WF and L1A can use them 

# 

# Constants Mod Entries 

# 

BEG_OF_GLOBALS = 

GLOB_VERS = ANC07 Globals v2 . 0 October 2001 

# 

# Mean Ellipsoid Radius 

# 

ELLIPAE = 6378136. 49d0 

# 

# Inverse of Ellipsoid Flattening 

# 

ELLIPF = 298 . 25645d0 

# 

# delta lat for DEM grid 

# 

DEMdLat = 0 . 00833333333333d0 

# 

# delta Ion for DEM grid 

# 

DEMdLon = 0 . 00833333333333d0 

# 

# Start latitude on the DEM grid 

# 

DEMLAT_BEG = 90 . 00416666666667d0 

# 

# Start longitude on the DEM grid 

# 

DEMLON_BEG = - 0 . 0 04 16 66 66 6 66 67d0 

# 

# The offset from the GPS reference time (00:00 Jan 1, 1980) 

# to the UTC reference time (12:00 Jan 1, 2000) 

# 

GPStoUTCof f set = -2001.10980499199991 

# 

# Max PAD offset allowed (max off-nadir pointing angle) 

# 

MAXPADOFF = 0 . 5d0 

# 

# 1064 energy Calibration coefficient for Received WFs 

# 

gd_calibcoef rec = 0.002351d0 

# 

# 1064 energy Calibration coefficient for transmitted WFs 

# 

gd_calibcoef tr = 0.00018d0 

# 

END_OF_GLOBALS = 

# 

END OF ANC07 FILE = 
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5.4 Invalid Values and Error/Status Reporting 

This section documents the use of standardized methods of dealing with invalid data and 
error/status conditions. 

5.4.1 Invalid Values 

Not all data received from GLAS will be suitable for science processing. In addition, given 
the nature of the raw telemetry packets, some data may be missing. The concept of an “invalid 
value” is used to signify that data is invalid or missing and should not be used for processing. 
Invalid values are datatype-specific values which are defined in the GLAS global constants 
module. These variables are assigned to Product variables in order to indicate invalid or miss- 
ing data. These values are defined in Table 5-8. 


Table 5-8 Invalid Values 


Datatype 

Invalid Value 

1 byte integer 

127 

2 byte integer 

32767 

4 byte integer 

2147483647 

4 byte real 

3.40282E+38 

X7F7FFFFF 

8 byte real 

1 .79769309486231 6E+308 
X7FEFFFFFFFFFFFFF 


5.4.2 Error and Status Codes 

GSAS uses a common error/status reporting facility. This ensures that error/status reporting is 
handled in a consistent manner throughout the software. This facility is based on the ANC07 
error file and is configurable by the user. 

5.4.2. 1 ANC07 Error File Format 

The ANC07 error file is in standard GSAS “keyword=value” format. See Section 5.3.2 for 
details of the fonnat. As with other ANC07 files, the sections for error and status must be 
delimited by section identifiers. Identifiers for each section are listed below. 

BEG_OF_STATUS= 

. . .Status section contents. . . 

END_0 F_S TATU S = 

BEG_OF_ERROR= 

. . .Error section contents. . . 

END_OF_ERROR 

The format of the error/status content is defined in Figure 5-1. The keyword can have the 
value of “ERROR” or “STATUS”. This identifies if the line contains an error or status entry. 
The value is a text string with the specific format defined in Table 5-9. 
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Figure 5-1 Error Ancillary File Format 


KEY- 

WORD=nnnnnnxttttttttttttttttttttttttttttttttttttttttttttttttttxsxf f f f f f 


Table 5-9 Error String Format 


Character 

Positions 

Description 

n 

1-6 

Error code (must be sequential within a section) 

X 

7,58,60 

Space character (delimiter) 

t 

8-57 

Message 

s 

59 

Error severity (see Table 5-11) 

f 

61-66 

Frequency of reporting (message is reported on 1st occurrence, then 
every f’th time) 


Table 5-10 Error Sections 


Starting Numbers 

Description 

-10001/10001 

General error/status. 

-20001/20001 

LI A error/status. 

-30001/30001 

Waveform error/status 

-40001/40001 

Atmosphere error/status 

-50001/50001 

Elevation error/status. 


There is a specific error number for each error/status value. Within the ANC07 file, these error 
numbers are numerically split into multiple sub-sections. Errors have negative numeric desig- 
nations; status messages have positive designations. 

Each major portion of the GSAS software supported by the specific error file begins at a dif- 
ferent subsection number. Within a subsection, error numbers must be consecutive The use of 
sub-sectioning is optional for a simple error file. The GSAS ANC07 error file has 5 subsec- 
tions. Table 5-10 lists each of the subsections and their starting error/status number. 

5. 4. 2.2 Use 

GLAS error messages are designed to inform a user when the software has encountered a 
problem. GLAS status messages are designed to assist the user in observing the flow of the 
processing. Status messages usually alert the user when the software begins execution of a 
subroutine. A great deal of flexibility was designed into this software in order to allow the 
user to customize the error/status display. 

The user may modify error and status entries in order to configure the severity of the error and 
frequency of printout. The user is cautioned to seek GLAS change-control board approval 
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before modifying the severity of an error. GSAS software will terminate processing upon 
receipt of a fatal severity code. Thus, modifying the severity may enable the software to exe- 
cute in a non-tested mode. 

The severity column controls how the GLAS software reacts when an error occurs. The 4 lev- 
els of severity are described in Table 5-11. GLAS software will terminate on a Fatal error. The 
frequency column controls how often an error message is printed out. The first instance of a 
specific error is always printed. Subsequent instances are printed out at the frequency speci- 
fied. All instances are counted and the number of occurrences printed in an output summary. 


Table 5-11 

Error Severity Codes 

Severity 

Description 

0 

No error 

1 

Information/status 

2 

Warning 

3 

Fatal 


5.4.2. 3 Error/Status File Content 


GLAS Error/Status messages and explanatory text are found in Appendix D of this document. 
HP Runtime error listings are found in Appendix D, as well. 

5.4.2.4 Sample ANC07 Error/Status File 

Following is a sample ANC07 error/status file. It has been trimmed down significantly for 
brevity. 


# 

# GLAS ANC07 Error File 

# 

# STATUS Section 

# 


BEG_OF_STATUS= 

STAT_VERS = ANC07 Status VERSION # 
# 

# Exec 

# 


#TATUS=nnnnnnxttttttttttttttttttttttttttttttttttttttttttttttttttxnxnnnnnn 


STATUS=10001 Number of Records Processed: 0 10 

STATUS=10002 Number of Records Read: 0 10 

# 

# L1A 

# 

#TATUS=nnnnnnxttttttttttttttttttttttttttttttttttttttttttttttttttxnxnnnnnn 
L_Alt subroutine status 0 

L Atm subroutine status 0 


10 

10 


STATUS=2 0 0 01 
STATUS=2 0 0 02 
# 

# Waveform 

# 

#TATUS=nnnnnnxttttttttttttttttttttttttttttttttttttttttttttttttttxnxnnnnnn 
STATUS=3 0 0 01 W_Assess subroutine status 0 9000 
STATUS=30002 W FunctionalFt subroutine status 0 9000 
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# 

# Atmosphere 

# 

#TATUS=nnnnnnxttttttttttttttttttttttttttttttttttttttttttttttttttxnxnnnnnn 
STATUS=40001 A_aer_lays subroutine status 0 7000 

STATUS=40002 A aer opt prop subroutine status 0 7000 

# 

# Elevation 

# 

#TATUS=nnnnnnxttttttttttttttttttttttttttttttttttttttttttttttttttxnxnnnnnn 
STATUS=50001 In E_CalcLoadTd subroutine status 0 1000 

STATUS=50002 IN E_CalcOceanTd subroutine status 0 1000 

# 

END_OF_STATUS = 

# 

#======================================================================== 

# 

# ERROR Section 

# 

BEG_OF_ERROR = 

ERR_VERS = ANC07 Error V2_exec_split 12 February 2001 

# 

# Exec 

# 

#RROR=nnnnnnxttttttttttttttttttttttttttttttttttttttttttttttttttxnxnnnnnn 
ERROR=-10001 Error Opening File for Input: 3 1 

ERROR=-10002 No control file specified. 3 1 

# 

# L1A 

# 

#RROR=nnnnnnxttttttttttttttttttttttttttttttttttttttttttttttttttxnxnnnnnn 
ERROR=-20001 Error reading PAD data Eng data 3 2 

ERROR=-20002 Error reading PAD data Eng data 3 1 

# 

# Waveform 

# 

#RROR=nnnnnnxttttttttttttttttttttttttttttttttttttttttttttttttttxnxnnnnnn 
ERROR=-30001 Singular Matrix 1 1 

ERROR=-30002 Number of peaks found greater than max 1 9000 

# 

# Atmosphere 

# 

#RROR=nnnnnnxttttttttttttttttttttttttttttttttttttttttttttttttttxnxnnnnnn 
ERROR= -40001 DEM out-of-bounds 1 50 

ERROR=-40002 532 integrated return flag poor or bad 1 50 

# 

# Elevation 

# 

#RROR=nnnnnnxttttttttttttttttttttttttttttttttttttttttttttttttttxnxnnnnnn 
ERROR=-50001 Error reading met height file 3 1 

ERROR=-50002 Error reading met temperature file 3 1 

# 

END_OF_ERROR = 

# 

# 

END OF ANC07 FILE = 
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5.4.3 Result Codes 

All GSAS PGEs return a result code indicating success or failure. The result code may be 
checked by referencing $? (bourne sh). The result code values are a subset of the error/status 
codes and are defined in Table 5-12. 


Table 5-12 Result Codes 


Severity 

Description 

0 

No error 

3 

Fatal error 


5.5 ANC06 Metadata/Log File 

5.5.1 ANC06 Overview 

GSAS software creates ANC06 output files as required by GSDP-3 1100 (refer to the GLAS 
Science Software Requirements Document). The ANC06 file contains processing informa- 
tion, error messages, and status messages. 

5.5.2 Format 

The file is in a modified version of the GSAS keyword=value fonnat. The format of an 
ANC06 entry is: 

[rec_ndx] [keyword] = [value] 

The first field [rec ndx] is the current record index. This correlates to the time of the data 
being processed when the entry was written (if no data have been processed, the value may be 
0 or an invalid value). The second field [keyword] is a keyword describing the type of infor- 
mation presented. The third field [value] is a fonnatted text message describing the event. 
Comments are allowed in order to group messages logically. Comment lines are pre-pended 
by the pound (#) sign. 

The value field has several subfields. The first field is the numeric error code. The second 
field is the error severity. The third field is the name of the routine which reported the error. 
The fourth field is the standard error text with optional detailed text. The fonnat of the sub- 
fields within the value field is shown below: 

error_num, severity, calling_routine , std_message opt_text 

5.5.3 Use 

ANC06 files are designed to be human-readable. However, there are techniques which can 
make retrieval of information from these files easier. The UNIX grep command is a valuable 
tool which can be used to extract information from the ANC06 files. 

For example, to find all enors within an ANC06 file: 

grep -i ERROR anc06_f ilename 

To find all version infonnation, 
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grep -i VERS anc06_filename 
To display control file infonnation: 

grep -i CONTROL anc06_filename 

5.5.4 ANC06 Example and Description 

An example ANC06 file is provided in Appendix C. 
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Section 6 

GLAS_LOproc 


6.1 Function 

GLASLOproc (sometimes referred to as GLOP) reads GLAS Level-0 APID files, ANC47 
construction records, ANC07 constants, and the ANC33 time conversion file to create ANC29 
and ANC32 ancillary files which will be used in LI A processing. The ANC29 file is used by 
GLAS L1A to read the APID files in a time-aligned manner. The ANC32 file is used by 
GLAS L1A to allow the computation of precise timing infonnation via a GPS reference. 
GLAS LOproc should be run once all GLAS APID files for a particular 6-hour period have 
been received by the data processing facility. GLAS LOproc does not permit multi-granule 
input or output files. 

6.2 Input Files 

Table 6-1 lists the required inputs to GLAS LOproc. Files which are specific to 
GLAS LOproc are documented in this section. See the appropriate section of this document or 
the GLAS Data Products Specifications Volumes for details regarding the those files not spe- 
cific to GLAS LOproc. 


Table 6-1 GLAS LOproc Inputs 


File Spec 

Type 

Source 

Short Description 

glaOO* 7777.dat 

Level-0 APID 

EDOS 

GLAS Level-0 APID files (one 
file per each APID type). 

anc07*_0000.dat 

Static Ancillary 

Science Team 

GLAS error file. 

anc07*_0001 dat 

Static Ancillary 

Science Team 

GLAS global constants file. 

anc47* 7777.dat 

Dynamic Ancillary 

EDOS 

APID construction records. 

anc33*.dat 

Dynamic Ancillary 

ISIPS Operations 

Counter-to-UTC conversion file. 

Control File 

Control 

ISIPS Operations 

Control file. 


6.2.1 GLAOO APID Files 

The GLAOO APIDs are Level-0 multi-rate spacecraft data files provided to the GLAS data 
processing facility by EDOS. There is a separate file for each specific APID type received 
from the spacecraft. These files are documented by the GLAS Instrument Team. 

After delivery from EDOS, these files are renamed to comply with GLAS standard naming 
conventions by SDMS. The start time in the control file entry for the APIDs is used to deter- 
mine the approximate UTC time for the data. This is important for finding the correct MET- 
to-UTC conversion entry in the ANC32 file. 

GLAS LOproc processes the APIDs listed in Table 6-2. 
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Table 6-2 APIDs Processed by GLAS LOproc 


APID 

Filename 

Description 

12 

gla00*_001 2.dat 

Altimeter Digitizer Large Sci Pkt 

13 

gla00*_0013.da 

Altimeter Digitizer Small Sci Pkt 

14 

gla00*_001 4.dat 

Altimeter Digitizer Eng Pkt 

15 

gla00*_001 5.dat 

Photon Counter Sci Pkt 

16 

gla00*_001 6.dat 

Photon Counter Eng Pkt 

17 

gla00*_001 7.dat 

Cloud Digitizer Sci Pkt 

18 

gla00*_001 8.dat 

Cloud Digitizer Eng Pkt 

19 

gla00*_001 9.dat 

Ancillary Science Pkt 

20 

gla00*_0020.dat 

CT HW telemetry #1 Data Pkt 

21 

gla00MJ021.dat 

CT HW Telemetry #2 Data Pkt 

22 

gla00*_0022dat 

CT HW Telemetry #3 Data Pkt 

23 

gla00*_0023.dat 

CT HW telemetry #4 Data Pkt 

24 

gla00*_0024.dat 

Small Software #1 Tim 

25 

gla00*_0025.dat 

Large Software Telemetry #1 Packet 

26 

gla00*_0026.dat 

LPA Data Pkt 

27 

gla00*_0027.dat 

Memory Dwell Packets 1 

28 

gla00*_0028.dat 

Memory Dwell Packets 2 

31 

gla00MJ031.dat 

DSP Code Memory Dump 

32 

gla00*_0032.dat 

DSP Data Memory Dump 

33 

gla00*_0033.dat 

C & T Dwell Packet 

34 

gla00*_0034.dat 

Event Message Packet 

35 

gla00*_0035.dat 

Memory Dump Packet 

36 

gla00*_0036.dat 

Table Dump Packet 

38 

gla00*_0038.dat 

Boresite Calibration Packet 

48 

gla00*_0048.dat 

GLAS Data Types Packet 

49 

gla00*_0049.dat 

Command History Packet 

50 

gla00*_0050.dat 

CT HW telemetry #5 Data Pkt 

55 

gla00*_0055.dat 

Large Software Telemetry #2 Packet 

126 

gla00*_01 26.dat 

LPA Test Packet. 
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Table 6-2 APIDs Processed by GLAS LOproc (Continued) 


APID 

Filename 

Description 

1984 

gla00*_1 984.dat 

GLAS PRAP Packet 

1088 

gla00*_1 088.dat 

GPS Receiver Data Packet 


6.2.2 ANC33 Counter to UTC Conversion File 

The ANC33 file is used to convert mission-elapsed time (MET), which is provided in the 
APIDs, to GLAS-standard UTC time. Since the MET can be re-set by a roll-over or a space- 
craft upset it is important that this file be maintained and provided to the GLAS processing 
facility in a timely manner. The file is delivered to ISIPS from the ISF as described in the ISF/ 
ISIPS Interface Control Document. 

ANC33 file is a ANSI text file. Each line contains data for a single entry in the file (data 
should not be hard wrapped). Comment lines are allowed and prepended by a # character. 
Each line contains the following information: 

d_shdr_count <sp> d_shdr_count_prap <sp> d_utc <sp> 
d_glas_osc_rate <sp> d_sc_osc_rate <sp> d_tdelay_digtzr <sp> 
d_rdelay_digtzr <sp> d_plTbias <sp> d_plRbias <sp> 
i_trkr_subj ectl <sp> i_trkr_subj ect2 <sp> i_trkr_subj ect2 
<sp>implement_time 

Each field is defined in Table 6-3. 


Table 6-3 ANC33 Field Descriptions 


Field 

Description 

d_shdr_count 

double precision : the counter value in the secondary header on MOST 
APIDS 

d_shdr_count_prap 

double precision: the counter value in the secondary header of PRAP 

d_utc 

double precision: the J2000 UTC time in seconds to which the counter val- 
ues are converted 

dglasoscrate 

double precision: the GLAS oscillator rate 

d_sc_osc_rate 

double precision: the Spacecraft oscillator rate 

d_tdelay_digtzr 

double precision: time delay for digitizer in seconds 

d_rdelay_digtzr 

double precision: internal range delay for digitizer in m 

d_plTbias 

double precision: post launch time bias in seconds 

d_plRbias 

double precision: post launch range bias in m 

i_trkr_subject(1) 

integer: the subject indicator for LRS tracker 0 

i_trkr_subject(2) 

integer: the subject indicator for LRS tracker 1 
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Table 6-3 ANC33 Field Descriptions (Continued) 


Field 

Description 

i_trkr_subject(3) 

integer: the subject indicator for LRS tracker 2 

d_implement_time 

double precision: the J2000 UTC time in seconds where the data for this 
entry are first valid 


Note that the Implement time is the UTC time at which this conversion was valid. 
GLASLOproc uses the designated start time of the first APID specified in the control file to 
find the correct position within the ANC33 file based on the Implement time field. 

Example: 

# 

# GLAS ISF/GLAS ISIPS Interface file 

# 

# This file is delivered to ISIPS from the ISF as described in the 

# ISF/ISIPS Interface Control Document. 

# 

0000000000000000 0000000000000000 - 00043200.0 1.0 1.0 0.00001511 9.5 0.0 0.0 0 

1 

2 0000000000000 

0000000100000000 0000000200000000 - 00043200.0 1.0 0.99999 0.00001501 9.6 0.0 

0.1 0 

2 1 0000000086400 

Note that the data are read free-fonnat and are not restricted to a certain precision or number 
of columns. Although the example lines are wrapped to fit on a page, each entry should be 
contained on a single line (soft wrapping is OK). 

6.2.3 ANC47 Construction Record 

EDOS provides construction records for each APID they provide to GSAS. Construction 
records have information which indicates if APID packets were “filled” by EDOS. A filled 
packet is one which was corrupt or incomplete when received from a ground station. 

GLAS LOproc parses the construction record, determines the position of filled packets, and 
then skips those packets during processing. 

6.2.4 Control File 

The control file fonnat and common elements are documented in Section 5 of this document. 
Elements specific to GLAS LOproc are described in this section. 

The control file section delimiter for GLAS LOproc is: 

=GLAS_L0P 

Since GLAS LOproc has no requirement for execution scenarios, there are no unique key- 
words for the GLAS LOproc control file. GLAS LOproc will perform all functions based on 
the presence of input and output files within the control file. 
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6.3 Output Files 

Table 6-4 lists the outputs created by GLASLOproc. Files which are specific to 
GLASLOproc are documented in this section. See the appropriate section of this document or 
the GLAS Data Products Specifications Volumes for details regarding the files which are not 
specific to GLAS LOproc. 


Table 6-4 GLAS LOproc Outputs 


File Spec 

Type 

Destination 

Short Description 

anc29*.dat 

Dynamic Ancillary 

GLAS_L1A 

Index file correlating APID 
times. 

anc32*.dat 

Dynamic Ancillary 

GLAS_L1A 

Frequency board to GPS time 
correlation file. 

anc06*.dat 

Dynamic Ancillary 

ISIPS Operations 

Standard metadata/processing 
log file. 


6.3.1 ANC29 Index File 

The ANC29 index file provides GLAS L1A with a method of time-correlating the GLAS 
APID files. It contains an index record for every record in the set of input APID files. ANC29 
is a binary, fixed-length record file. Its content is described in Table 6-5. 


Table 6-5 ANC29 File Content 


Type 

Name 

Description 

double 

utctime 

J2000 UTC time in seconds of the APID. 

long int 

rec_ndx 

Unique record index of the APID group. (Nominally, (utctime-offset) * 10) 

long int 

shot_ctr 

Shot counter (if available). 

long int 

rec_num 

Physical record number in the APID file. 

long int 

apid 

APID identification number. 

long int 

dqflag 

Data quality flag (0=good data). 

short int 

sort_order 

Sort order (for internal use). 

shor t int 

spare 

Spare (for internal use). 


6.3.2 ANC32 GPS File 

The ANC32 GPS file provides GLAS L1 A with a method of computing precise timing calcu- 
lations based on the last update of the onboard GPS. It contains records identifying each time 
the GPS clock is updated within the APID packets. ANC32 is a binary, fixed-length record 
file and nominally occurs at a rate of one record every 10 seconds. Its content is described in 
Table 6-6. 
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Table 6-6 ANC32 File Content 


Type 

Name 

Description 

long int 

rec_ndx 

Unique record index of the APID group. (Nominally, (utctime- 
offset) * 10) 

short int 

i_ScPosPktShot 

APID 19/1182 Shot count for 1553 Spacecraft Time & Pos 
packet. 

short int 

i_useflag 

Flag indicating if the data are valid (0=valid, other=not valid) 

double 

d_utctime 

J2000 UTC time in seconds from secondary header of packet 
where GPS changed. 

double 

d_FTLatch 

APID 19/1195 GPS 10 Sec Pulse 40 bit count value 

double 

d_ScPosPktGMET 

APID 19/1184 GLAS MET for 1553 Spacecraft Time & Pos 
packet. 

double 

d_VTCW 

APID 19/1142 Spacecraft VTCW (start of SC Time & Pos pkt) 

double 

d_VTCWp 

APID 19/1182 VTCW and at time of 0.1 Hz pulse (end of SC 
Time & Pos pkt) 

double 

d_GPSTime 

APID 19/1172 GPS time in Seconds 

double 

d_GPSppsGMET 

PID 19/1201 GLAS MET for GPS 0.1 Hz Pulse 


6.4 Processing and Reprocessing Scenarios 

GLASLOproc supports only a full-processing scenario. Additionally, all available APIDs 
files and ANC47 construction records for a specific time period must be processed during the 
same run. Only one valid ANC29/32 file is pennitted for a time period. If additional corre- 
sponding APIDs are received at a later date, a|l of the APIDs for that particular period must be 
re-processed to create replacement ANC29/32 files. 

Time-selected processing is not supported. The start and stop times on the INPUTFILE and 
OUTPUTFILE control file entries are ignored for processing, but are critical for finding the 
correct time of data during ANC33 file searche s. 

6.5 Startup and Termination 

This is an overview of the steps necessary to run GLAS LOproc. 

6.5.1 Setup a Runtime Directory 

The suggested method of running GLAS LOproc is to create a temporary directory and link 
all necessary files into it. For example, to setup a GLAS LOproc run, one would perform the 
following steps (Designate TEMPDIR as the temporary directory and DATA DIR as the 
location in which input data for this job has been staged): 

mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/GLAS_LOproc . 
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In -s $GLAS_HOME/lib/* . 

In -s $GLAS_HOME/data/anc07* . dat . 
In -s $GLAS_HOME/data/anc33* .dat . 
In -s $DATA_DIR/* .dat . 


6.5.2 Create a Control File 

GLASLOproc is designed to take the name of a control file as a command-line argument. The 
suggested method of creating a control file is by copying a template from the 
$GLAS_HOME/data directory and modifying it with desired input/output filenames and data 
processing options. 


cp $GLAS_HOME/data/cf_glas_10proc . ctl . / control_file_name 
vi . / control_file_name 

6.5.3 Run the PGE 


Error and status messages will be displayed on screen (stdout) and recorded in the ANC06 
file. 


. /GLAS_LOproc control_f ile_name 

6.5.4 Run-Time Statistics 

GLAS LOproc processes 6 hours of GLAS data in less than 2 minutes. This may vary due to 
hardware load and data dependencies. 

6.5.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. The log / 
metadata file (ANC06*) must be examined to determine runtime success. Additionally, the 
process will return a result code to the operating system which may be used to programmati- 
cally detennine success or failure (0=success, 3=fatal error). 

6.6 Error and Warning Messages 

All GSAS error and warning messages are listed numerically in Appendix D. 

6.7 Recovery Steps 

If GLAS LOproc tenninates with an error: 

1) Review error and status messages in the ANC06 file or on stdout to detennine 
source or location of problem. Refer to errors listed in Appendix D for assistance in 
detennining the problem. 

2) Conect the problem 

3) Remove previous output files 

4) Re-run the software 

In case of a problematic error, which cannot be easily diagnosed, debug versions of 
GLAS LOproc will be available for test use. This is, however, more of a developer procedure 
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than a user procedure. Software users should contact the GSAS Development Team for more 
instructions. 

6.8 Sample GLAS_LOproc Control File 

=GLAS_L0P 

# granule_id = 6181582 

INPUT_FILE=GLAO 0_0 03_2 0 04 02 19_18 0 0 0 0_01_0 012 . DAT 130485600 130507061 3 1 0 

# granule_id = 6181614 

INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0 0 0 0_01_0 05 0 . DAT 130485600 130507168 3 1 0 

# granule_id = 6181598 

INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0 0 0 0_01_0 022 . DAT 130485600 130507184 3 1 0 
INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0 0 0 0_01_0 023 . DAT 130485600 130507184 3 1 0 

# granule_id = 6181594 

INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0 0 0 0_01_0 02 0 . DAT 130485600 130507196 3 1 0 
INPUT_FILE=GLA0 0_003_2 0 04 02 19_18 0 0 0 0_01_0 02 1 . DAT 130485600 130507196 3 1 0 

# granule_id = 6181590 

INPUT_FILE=GLA0 0_003_2 0 04 02 19_18 0 0 0 0_01_0 015 . DAT 130485600 130507199 3 1 0 
INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0 0 0 0_01_0 017 . DAT 130485600 130507199 3 1 0 
INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0 0 0 0_01_0 019 . DAT 130485600 130507199 3 1 0 
INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0 0 0 0_01_0 02 6 . DAT 130485600 130507199 3 1 0 
INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0 0 0 0_01_1984 . DAT 130485600 130507199 3 1 0 

# granule_id = 6181602 

INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0 0 0 1_01_0 024 . DAT 130485601 130507197 3 1 0 
INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0 0 0 1_01_0 025 . DAT 130485601 130507197 3 1 0 
INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0 0 0 1_01_0 055 . DAT 130485601 130507197 3 1 0 

# granule_id = 6181618 

# granule_id = 6181586 

INPUT_FILE=GLA0 0_0 03_2 0 04 02 19_18 0433_01_0 013 . DAT 130485873 130507199 3 1 0 

# granule_id = 6181606 

# granule_id = 7509819 
INPUT_FILE=anc07_026_01_0000 . dat 0 0 
INPUT_FILE=anc07_026_01_0001 . dat 0 0 
INPUT_FILE=anc07_026_01_0002 . dat 0 0 
INPUT_FILE=anc07_026_01_0003 . dat 0 0 
INPUT_FILE=anc07_026_01_0004 . dat 0 0 
INPUT_FILE=anc07_026_01_0005 . dat 0 0 
INPUT_FILE=anc07_026_01_0006 . dat 0 0 

# granule_id = 7328803 

INPUT_FILE=ANC33_001_20051020_000000_01_0000 .DAT 0 0 

# granule_id = 6181334 

INPUT_FILE=ANC47_003_2 0 04 02 19_2243 3 8_01_0 013 . DAT 130502618 130507199 

# granule_id = 6181338 

INPUT_FILE=ANC47_003_2 0 04 02 19_2243 3 9_01_0 015 . DAT 130502619 130507199 
INPUT_FILE=ANC47_0 03_2 0 04 02 19_2243 3 9_01_0 017 . DAT 130502619 130507199 
INPUT_FILE=ANC47_0 03_2 0 04 02 19_2243 3 9_01_0 019 . DAT 130502619 130507199 
INPUT_FILE=ANC47_0 03_2 0 04 02 19_2243 3 9_01_0 02 6 . DAT 130502619 130507199 

# granule_id = 6181340 

INPUT_FILE=ANC47_0 03_2 0 04 02 19_22434 0_01_0 02 0 . DAT 130502620 130507196 
INPUT_FILE=ANC47_0 03_2 0 04 02 19_22434 0_01_0 02 1 . DAT 130502620 130507196 

# granule_id = 6181366 

INPUT_FILE=ANC47_0 03_2 0 04 02 19_22434 0_01_1984 . DAT 130502620 130507199 

# granule_id = 6181348 

INPUT_FILE=ANC47_0 03_2 0 04 02 19_22434 1_01_0 024 . DAT 130502621 130507197 
INPUT_FILE=ANC47_0 03_2 0 04 02 19_22434 1_01_0 025 . DAT 130502621 130507197 
INPUT_FILE=ANC47_0 03_2 0 04 02 19_22434 1_01_0 055 . DAT 130502621 130507197 

# granule_id = 6181356 
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INPUT_FILE=ANC4 7_0 03_2 0 04 02 19_224344_01_0 05 0 . DAT 

# granule_id = 6181344 

INPUT_FILE=ANC47_0 03_2 0 04 02 19_224344_01_0 022 . DAT 
INPUT_FILE=ANC47_0 03_2 0 04 02 19_224344_01_0 023 . DAT 

# granule_id = 6181360 

# granule_id = 6181330 

INPUT_FILE=ANC47_0 03_2 0 04 02 19_224424_01_0 012 . DAT 

# granule_id = 6181352 

OUTPUT_FILE=ANC2 9_02 6_2 0 04 021 9_1 8 0 0 0 0_0 1_0 0 01. DAT 
OUTPUT_FILE=ANC2 9_026_2 0 04 0219_22434 0_0 1_0 0 01. DAT 
OUTPUT_FILE=ANC32_026_2 0 04 02 19_1 8 0 0 0 0_0 1_0 0 01. DAT 
OUTPUT_FILE=ANC32_026_2 0 04 0219_22434 0_0 1_0 0 01. DAT 
OUTPUT FILE=ANC0 6 026 20060215 531686 01 GLAS LOP 


130502624 

130502624 

130502624 

130502664 


130507168 

130507184 

130507184 

130507061 


13 

04 

85 

600 

13 

13 

05 

02 

620 

13 

13 

04 

85 

600 

13 

13 

05 

02620 

13 

txt 

13 

048560 


0507199 
0507199 
0507199 
0507199 
0 130507199 
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Section 7 

GLAS L1A 


7.1 Function 

GLAS L1A uses calibration and conversion equations detennined during GLAS system test- 
ing to convert the measured counts within the GLAOO data into engineering units. This con- 
version process is detailed in the LI A ATBD. Some data do not require conversion and will be 
copied directly from the input to the appropriate output product. GLAS L1A computes pre- 
cise time -tagging information for each laser shot and produces quality assurance measure- 
ments used to determine the quality of the data processed. 

GLAS L1A reads GLAS Level-0 APID fdes, ANC20, ANC25, ANC29, ANC32, ANC33, 
ANC45 and ANC07 ancillary files to create GLAS Li A product files. The ANC29 file is used 
by GLAS L1A to read the APID files in a time-aligned manner. The ANC32 file is used by 
GLAS L1A to allow the computation of precise timing information via a GPS reference. The 
ANC20 file is used to compute location from the predicted orbit. The ANC07 files are read to 
initialize constants and error/status messages. The ANC45 files are used to initialize metadata/ 
header infonnation. 

ANC29, ANC32, and the corresponding GLAOO APIDs should be considered a single, insep- 
arable data set. It is critical that the appropriate ANC29/32 files be provided for each distinc- 
tive set of GLAOO APIDs provided as input. ANC29 is the index by which the APIDs are read 
in a time-aligned fashion. Without ANC29 files which correlate to the input GLAOO APIDS, 
processing will fail. Likewise, without ANC32 files, precision time computations will fail. 

GLAS L1A should be run after successful execution of GLAS LOproc. GLAS L1A permits 
multi-granule input or output files, input/output time selection and selected execution. 

7.2 Input Files 

Table 7-1 lists the inputs files to GLAS L1 A. Files which are specific to GLAS L1A are doc- 
umented in this section. See the appropriate section of this document or the GLAS Data Prod- 
ucts Specifications Volumes for details. 


Table 7-1 GLAS_L1A Inputs 


File Spec 

Type 

Source 

Short Description 

glaOO* 7777.dat 

Level-0 APID 

EDOS 

Level-0 APID files (one file per 
each APID type). 

anc07*_0000.dat 

Static Ancillary 

Science Team 

Error file. 

anc07*_0001 dat 

Static Ancillary 

Science Team 

Global constants file. 

anc07*_0005.dat 

Static Ancillary 

Science Team 

LI A constants file. 

anc25*.dat 

Dynamic Ancillary 

Science Team 

GPS/UTC conversion file. 
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Table 7-1 GLAS_L1A Inputs (Continued) 


File Spec 

Type 

Source 

Short Description 

anc29*.dat 

Dynamic Ancillary 

GLAS_L0proc 

Index file correlating APID 
times. 

anc32*.dat 

Dynamic Ancillary 

GLAS_L0proc 

Frequency board to GPS time 
correlation file. 

anc33*.dat 

Dynamic Ancillary 

Science Team 

UTC time conversion file. 

anc20*.dat 

Dynamic Ancillary 

UTexas 

Predicted orbit file. 

anc45*_0001 .dat 

Static Ancillary 

Science Team 

GLA01 metadata input file. 

anc45*_0002.dat 

Static Ancillary 

Science Team 

GLA02 metadata input file. 

anc45*_0003.dat 

Static Ancillary 

Science Team 

GLA03 metadata input file. 

anc45*_0004.dat 

Static Ancillary 

Science Team 

GLA04 metadata input file. 

Control File 

Control 

ISIPS Operations 

Control file. 


7.2.1 Control File 

The control file fonnat and common elements are documented in Section 5 of this document. 
Elements specific to GLAS L1A are described in this section. 

The control file section delimiter for GLAS L1A is: 

=GLAS_L1A 

In order to satisfy the partial execution requirement, GLAS L1 A can perform limited process- 
ing based on execution flags within the control file. The flags and the processes they control 
are defined in Table 7-2. 


Table 7-2 GLAS L1A Control Flags 


Flag 

Significance 

LI A_PROCESS=None 

Indicates that GLAS_L1A should perform no processing. 

L1A_PROCESS=L_ALT 

Indicates that GLAS_L1A should perform altimetry-related process- 
ing. 

LI A_PROCESS=L_ATM 

Indicates that GLAS_L1 A should perform atmosphere-related pro- 
cessing. 

LI A_PROCESS=L_ENG 

Indicates that GLAS_L1A should perform engineering processing. 

LI A_PROCESS=L_ATT 

Indicates that GLAS_L1 A should perform SRS/GPS/laser pointing 
processing. 

LI A_PROCESS=ALL 

Indicates that GLAS_L1 A should perform all processing. 


Combinations of the execution flags are allowed. For example, to perform both altimetry and 
engineering processing, the control file would have the following entries: 
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L1A_PR0CESS=L_ALT 

L1A_PR0CESS=L_ENG 

A control file option is available to designate that location information be taken from the 
APID data rather than the ANC20 predicted orbit file. This is useful for quick-look processing 
when the ANC20 is not yet available but should not be used for normal, production process- 
ing. To indicate that pass-thru processing should be used, add the following line to the control 
file: 


POS I T I ON= PAS S_THRU 

If this line is not included in the control file, ANC20 processing will occur by default. 

7.3 Output Files 

Table 7-3 lists the output files created by GLAS L1A. See the appropriate section of this doc- 
ument or the GLAS Data Products Specifications Volumes for details regarding the output 
files 

Granule boundaries are designated by specifying start and stop times on the OUTPUT FILE 
control file entries. 


Table 7-3 GLASL1A Outputs 


File Spec 

Type 

Destination 

Short Description 

gla01*.dat 

L1A Product 

GLAS_L1 A 

GLAS L1A Altimetry product file. 
Contains the waveforms and the 
altimeter and timing data 
required to produce higher level 
range and elevation products. 

gla02*.dat 

LI A Product 

GLAS_Atm 

GLAS L1A Atmosphere product 
file. Contains the normalized 
backscatter, photon counter, 
cloud digitizer, timing, and 
location data required to pro- 
duce the higher level atmo- 
sphere data products. 

gla03*.dat 

L1A Product 

Archive 

L1A Engineering product file. 
Contains the GLAS instrument’s 
engineering and housekeeping 
data. 

gla04*_0001.dat 

L1A Products 

UTEXAS 

LI A LPA product file. 

gla04*_0002.dat 

LI A Products 

UTEXAS 

LI A LRS product file. 

gla04*_0003.dat 

LI A Products 

UTEXAS 

LI A GYRO product file. 

gla04*_0004.dat 

L1A Products 

UTEXAS 

L1A 1ST product file. 

gla04*_0005.dat 

L1A Products 

UTEXAS 

LI A BST product file. 
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Table 7-3 GLASL1A Outputs (Continued) 


File Spec 

Type 

Destination 

Short Description 

gla04*_0006.dat 

L1A Products 

UTEXAS 

LI A SCPA product file. 

glaOD.qap 

L1A Quality 

QA 

LI A Altimetry quality file. 

gla02*.qap 

LI A Quality 

QA 

LI A Atmosphere quality file. 

gla03*.qap 

L1A Quality 

QA 

LI A Engineering quality file. 

anc06*.txt 

Dynamic Ancillary 

ISIPS Operations 

Standard metadata/processing 
log file. 


Of importance is the relationship between the execution flags and the output products. If a 
particular execution flag is present in the control file, then the corresponding output file type 
must be present as well. Table 7-4 shows the relationship between output products and execu- 
tion flags. 

Table 7-4 GLAS L1A Execution Flags and Requisite Output Products 


Execution Flag 

Required Output Product 

LI A_PROCESS=L_ALT 

glaOU.dat, qapOU.dat 

LI A_PROCESS=L_ATM 

gla02*.dat, qap02*.dat 

LI A_PROCESS=L_ENG 

gla03*.dat, qap03*.dat 

LI A_PROCESS=L_ATT 

gla04*.dat 


7.4 Execution Scenarios 

GLAS L1A supports multiple execution scenarios. Control files defining the requisite execu- 
tion flags as well as input and output files are shown for each supported scenario. For brevity, 
only those control file entries unique to the particular scenario are shown. Additionally, even 
though multiple files of the same time may be needed, a single instance is shown. 

Since the ANC29 and ANC32 files directly correspond to specific sets of APIDs, great care 
must be taken to ensure that the relative order of input files within the control file is correct. 
For example, the APID files which correspond to the first ANC29 file must be listed first in 
the control file relative to other APID files. Following the rule that input files are listed in time 
order guarantees the timing relationship between the APID files and the ANC29 files. 

All execution scenarios require the LENG processes to provide values for the L ALT and 
L ATM processes. It is possible to run these scenarios without creating a GLA03 file by not 
specifying GLA03 as an output in the control file. This is not recommended since data used 
will not be checked by post-processing QA processes. 

Time-selected processing may be performed by specifying specific start and stop times on the 
INPUT FILE and OUTPUT FILE control file entries. 
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During selective processing, only specific GLAOO APID input files are required. Processing 
will still occur if some of the APIDs are missing, but for full and complete processing those 
listed are required. Table 7-5 lists the execution flags and requisite GLAOO APID inputs. 


Table 7-5 GLAS. 

LI A Input APIDs 

Execution Flag 

Input APIDs 

LI A_PROCESS=L_ALT 

12/13, 19, 21 

LI A_PROCESS=L_ATM 

12/13, 15, 17, 19 

L1A_PROCESS=L_ENG 

12/13, 15, 17, 19, 20, 21, 22, 23, 
24, 25, 50, 55 

LI A_PROCESS=L_ATT 

12/13, 19, 26, 1984 


7.4.1 Standard Processing 

This scenario is used for nonnal LI A processing, creating GLA01, GLA02, GLA03 and 
GLA04 data from GLAOO APIDs and the requisite ANC files. In this scenario, all GLAOO 
APIDs are read. All input ANC files are required. 

7.5 Startup and Termination 

This is an overview of the steps necessary to run GLAS_L1A. 

7.5.1 Setup a Runtime Directory 

The suggested method of running GLAS L1A is to create a temporary directory and link all 
necessary files into it. The SDMS will create a temporary directory and link all necessary files 
into it. For example, to setup a GLAS L1A run, one would perform the following steps (Des- 
ignate TEMPDIR as the temporary directory and DATA DIR as the location in which input 
data for this job has been staged): 

mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/GLAS_LlA . 

In -s $GLAS_HOME/lib/* . 

In -s $GLAS_HOME/data/anc*.dat . 

In -s $D ATA_DIR/* . dat . 

7.5.2 Create a Control File 

GLAS L1A is designed to take the name of a control file as a command-line argument. The 
suggested method of creating a control file is by copying a template from the 
$GLAS_HOME/data directory and modifying it with desired input/output filenames and data 
processing options. 

cp $GLAS_HOME/data/cf_glas_lla.ctl ./control Jilejiame 
vi ./control Jilejiame 
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7.5.3 Run the PGE 

Error and status messages will be displayed on screen (stdout) and recorded in the ANC06 
fde. 


./GLAS_L 1 A control Jile_name 

7.5.4 Run-Time Statistics 

GLAS L1A processes 25 hours of GLAS data in approximately 3 hours. This may vary due to 
hardware load and data dependencies. 

7.5.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. The log / 
metadata file (ANC06*) must be examined to determine runtime success. Additionally, the 
process will return a result code to the operating system which may be used to programatically 
detennine success or failure (0=success, 3=fatal error). 

7.6 Error and Warning Messages 

All GSAS error and warning messages are numerically listed in Appendix D. 

7.7 Recovery Steps 

If GLAS L1A terminates with an error: 

1) Review error and status messages in the ANC06 file or on stdout to detennine 
source or location of problem. Refer to errors listed in Appendix D for assistance in 
detennining the problem. 

2) Conect the problem 

3) Remove previous output files 

4) Re-run the software 

In case of a problematic error, which cannot be easily diagnosed, debug versions of 
GLAS L1A will be available for test use. This is, however, more of a developer procedure 
than a user procedure. Software users should contact the GSAS Development Team for more 
instructions. 

7.8 Sample GLAS_L1A Control File 

=GLAS_L1A 
PGE_VERSION=5 . 0 

PASSID=4 3 02 21030020105 120640160 120645960 3.6570864 3127 
PASSID=4 3 03 21030020106 120645960 120651760 -20.537048 3128 
PASSID=4 3 04 21030020107 120651760 120657561 -44.732086 3129 

# granule_id = 6015263 

INPUT_FILE=GLA0 0_0 03_2 0 03 102 8_12 0 0 0 0_01_0 012 . DAT 120614400 120635476 3 1 0 

# granule_id = 6015271 

INPUT_FILE=GLA0 0_0 03_2 0 03 102 8_12 0 0 0 0_01_0 022 . DAT 120614400 120635984 3 1 0 
INPUT FILE=GLA0 0 003 20031028 120000 01 0023.DAT 120614400 120635984 3 1 0 
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# granule_id = 6015273 

INPUT_FILE=GLAO 0_0 03_2 0 03 102 8_12 0 0 0 0_01_0 024 
INPUT_FILE=GLAO 0_003_2 0 03 102 8_12 0 0 0 0_01_0 025 
INPUT_FILE=GLAO 0_0 03_2 0 03 102 8_12 0 0 0 0_01_0 055 

# granule_id = 6015267 

INPUT_FILE=GLAO 0_0 03_2 0 03 102 8_12 0 0 0 0_01_0 015 
INPUT_FILE=GLAO 0_0 03_2 0 03 102 8_12 0 0 0 0_01_0 017 
INPUT_FILE=GLAO 0_0 03_2 0 03 102 8_12 0 0 0 0_01_0 019 
INPUT_FILE=GLAO 0_0 03_2 0 03 102 8_12 0 0 0 0_01_0 02 6 
INPUT_FILE=GLAO 0_0 03_2 0 03 102 8_12 0 0 0 0_01_1984 

# granule_id = 6015269 

INPUT_FILE=GLAO 0_0 03_2 0 03 102 8_12 0 0 03_01_0 02 0 
INPUT_FILE=GLAO 0_0 03_2 0 03 102 8_12 0 0 03_01_0 02 1 

# granule_id = 6015277 

INPUT_FILE=GLAO 0_0 03_2 0 03 102 8_12 0 016_01_0 05 0 

# granule_id = 6015280 

# granule_id = 6015265 

INPUT_FILE=GLAO 0_003_2 0 03 102 8_12 0 1 04_01_0 013 

# granule_id = 6015292 

INPUT_FILE=GLAOO_003_20031028_180000_01_0013 

# granule_id = 6015298 

INPUT_FILE=GLAOO_003_20031028_180000_01_0022 

INPUT_FILE=GLAOO_003_20031028_180000_01_0023 

# granule_id = 6015294 

INPUT_FILE=GLAOO_003_20031028_180000_01_0015 

INPUT_FILE=GLAOO_003_20031028_180000_01_0017 

INPUT_FILE=GLAOO_003_20031028_180000_01_0019 

INPUT_FILE=GLAOO_003_20031028_180000_01_0026 

INPUT_FILE=GLAOO_003_20031028_180000_01_1984 

# granule_id = 6015300 

INPUT_FILE=GLAOO_003_20031028_180001_01_0024 

INPUT_FILE=GLAOO_003_20031028_180001_01_0025 

INPUT_FILE=GLAOO_003_20031028_180001_01_0055 

# granule_id = 6015296 

INPUT_FILE=GLAOO_003_20031028_180003_01_0020 
INPUT_FILE=GLAO 0_0 03_2 0 03 102 8_18 0 0 03_01_0 02 1 

# granule_id = 6015306 

# granule_id = 6015304 

INPUT_FILE=GLAOO_003_20031028_180016_01_0050 

# granule_id = 6015302 

# granule_id = 6015290 

INPUT_FILE=GLAOO_003_20031028_180150_01_0012 

# granule_id = 6015380 

# granule_id = 7295559 
INPUT_FILE=anc07_024_01_0000 . dat 0 0 
INPUT_FILE=anc07_024_01_0001 . dat 0 0 
INPUT_FILE=anc07_024_01_0002 . dat 0 0 
INPUT_FILE=anc07_024_01_0003 . dat 0 0 
INPUT_FILE=anc07_024_01_0004 .dat 0 0 
INPUT_FILE=anc07_024_01_0005 . dat 0 0 
INPUT_FILE=anc07_024_01_0006 . dat 0 0 

# granule_id = 6013024 

INPUT_FILE=ANC2 0_004_2 0 03 1027_23 594 7_01_0 0 01 

# granule_id = 40170 

INPUT_FILE=anc25_001_20021213_000000_01_0000 

# granule_id = 7348450 

INPUT_FILE=ANC2 9_024_2 0 03 102 8_12 0 0 0 0_01_0 0 01 

# granule_id = 7348452 

INPUT FILE=ANC2 9 024 20031028 180000 01 0001 


DAT 

120614400 

DAT 

120614400 

DAT 

120614400 

DAT 

120614400 

DAT 

120614400 

DAT 

120614400 

DAT 

120614400 

DAT 

120614400 

DAT 

120614403 

DAT 

120614403 

DAT 

120614416 

DAT 

120614464 

DAT 

120636000 

DAT 

120636000 

DAT 

120636000 

DAT 

120636000 

DAT 

120636000 

DAT 

120636000 

DAT 

120636000 

DAT 

120636000 

DAT 

120636001 

DAT 

120636001 

DAT 

120636001 

DAT 

120636003 

DAT 

120636003 

DAT 

120636016 

DAT 

120636110 


DAT 

120571187 

dat 

0 0 

DAT 

120614400 

DAT 

120636000 


120635997 310 
120635997 310 
120635997 310 

120635999 310 
120635999 310 
120635999 310 
120635999 310 
120635999 310 

120635999 310 
120635999 310 

120635984 310 


120635999 310 

120656882 310 

120657584 310 
120657584 310 

120657599 310 
120657599 310 
120657599 310 
120657599 310 
120657599 310 

120657597 310 
120657597 310 
120657597 310 

120657599 310 
120657599 310 


120657584 310 


120657599 310 


120657587 


120635999 

120657599 
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# granule_id = 7348451 

INPUT_FILE=ANC32_024_2 0 03 102 8_12 0 0 0 0_01_0 0 01. DAT 120614400 120635999 

# granule_id = 7348453 

INPUT_FILE=ANC32_024_20031028_180000_01_0001 . DAT 120636000 120657599 

# granule_id = 7328803 

INPUT_FILE=ANC33_001_20051020_000000_01_0000 . DAT 0 0 

# granule_id = 7291335 
INPUT_FILE=anc45_024_01_0001 . dat 0 0 
INPUT_FILE=anc45_024_01_0002 . dat 0 0 
INPUT_FILE=anc45_024_01_0003 . dat 0 0 
INPUT_FILE=anc45_024_01_0004 . dat 0 0 

# granule_id = 7344524 

OUTPUT_FILE=GLA01_024_2103_002_0105_1_01_0001 .DAT 120640968 120642248 24 1 1 

# granule_id = 7344528 

OUTPUT_FILE=GLAO 1_024_2 103_0 02_0105_2_0 1_0 0 01. DAT 120642248 120643864 24 1 2 

# granule_id = 7344532 

OUTPUT_FILE=GLAO 1_024_2 103_0 02_0105_3_0 1_0 0 01. DAT 120643864 120645152 24 1 3 

# granule_id = 7344536 

OUTPUT_FILE=GLAO 1_024_2 103_0 02_0105_4_0 1_0 0 01. DAT 120645152 120646768 24 1 4 

# granule_id = 7344540 

OUTPUT_FILE=GLAO 1_024_2 103_0 02_0106_1_0 1_0 0 01. DAT 120646768 120648048 24 1 1 

# granule_id = 7344546 

OUTPUT_FILE=GLAO 1_024_2 103_0 02_0106_2_0 1_0 0 01. DAT 120648048 120649664 24 1 2 

# granule_id = 7344555 

OUTPUT_FILE=GLAO 1_024_2 103_0 02_0106_3_0 1_0 0 01. DAT 120649664 120650952 24 1 3 

# granule_id = 7344563 

OUTPUT_FILE=GLA01_024_2 103_0 02_0106_4_0 1_0 0 01. DAT 120650952 120652568 24 1 4 

# granule_id = 7344512 

OUTPUT_FILE=GLA02_024_2 103_0 02_0105_0_0 1_0 0 01. DAT 120640968 120652568 24 1 0 

# granule_id = 7344513 

OUTPUT_FILE=GLA03_024_2 103_0 02_0105_0_0 1_0 0 01. DAT 120640968 120652568 24 1 0 

# granule_id = 7344514 

OUTPUT_FILE=GLA04_024_2103_002_0105_0_01_0001 .DAT 120640968 120652568 24 1 0 
OUTPUT_FILE=GLA04_024_2 103_0 02_0105_0_0 1_0 0 02. DAT 120640968 120652568 24 1 0 
OUTPUT_FILE=GLA04_024_2103_002_0105_0_01_0003 .DAT 120640968 120652568 24 1 0 
OUTPUT_FILE=GLA04_024_2 103_0 02_0105_0_0 1_0 0 04. DAT 120640968 120652568 24 1 0 
OUTPUT_FILE=GLA04_024_2 103_0 02_0105_0_0 1_0 0 05. DAT 120640968 120652568 24 1 0 
OUTPUT_FILE=GLA04_024_2 103_0 02_0105_0_0 1_0 0 06. DAT 120640968 120652568 24 1 0 

# granule_id = 7344525 

OUTPUT_FILE=GLA01_024_2103_002_0105_1_01_0001 . QAP 120640968 120642248 24 1 1 

# granule_id = 7344529 

OUTPUT_FILE=GLA01_024_2103_002_0105_2_01_0001 .QAP 120642248 120643864 24 1 2 

# granule_id = 7344533 

OUTPUT_FILE=GLA01_024_2103_002_0105_3_01_0001 . QAP 120643864 120645152 24 1 3 

# granule_id = 7344537 

OUTPUT_FILE=GLA01_024_2103_002_0105_4_01_0001 .QAP 120645152 120646768 24 1 4 

# granule_id = 7344541 

OUTPUT_FILE=GLA01_024_2103_002_0106_1_01_0001 . QAP 120646768 120648048 24 1 1 

# granule_id = 7344549 

OUTPUT_FILE=GLA01_024_2103_002_0106_2_01_0001 . QAP 120648048 120649664 24 1 2 

# granule_id = 7344557 

OUTPUT_FILE=GLA01_024_2103_002_0106_3_01_0001 . QAP 120649664 120650952 24 1 3 

# granule_id = 7344565 

OUTPUT_FILE=GLA01_024_2103_002_0106_4_01_0001 . QAP 120650952 120652568 24 1 4 

# granule_id = 7344515 

OUTPUT_FILE=GLA02_024_2103_002_0105_0_01_0001 . QAP 120640968 120652568 24 1 0 

# granule_id = 7344516 

OUTPUT_FILE=GLA03_024_2103_002_0105_0_01_0001 . QAP 120640968 120652568 24 1 0 
OUTPUT FILE=ANC0 6 024 20051027 477035 01 GLAS LlA.txt 0 0 
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Section 8 

GLAS Alt 


8.1 Function 

GLASAlt uses algorithms defined in the GSAS Detailed Design Document and related 
ATBDs to process the GLAS waveforms and compute elevation parameters. GLAS Alt func- 
tionality is divided into waveform and elevation processes. The waveform processes compute 
waveform parameters which are stored in the GLA05 file. The elevation processes use the 
waveform parameters, and (optionally) L2 atmosphere parameters, to compute elevation mea- 
surements which are stored in the GLA06 file and on the region-specific GLA12-15 files. 

GLAS Alt reads GLAS Level- 1 A product files and requisite ancillary files to create GLAS 
Altimetry product files. In its most basic execution, GLAS Alt reads the GLA01 products 
created by GLAS L1A to create GLA05, GLA06, and GLA12-15 products. However, in 
some execution scenarios, GLAS Alt can read the GLA05 or GLA06 files created in a previ- 
ous execution to produce GLA06 and/or GLA12-15 products. GLAS Alt uses the ANC07 
files for constants and error/status messages. It uses the global Digital Elevation Model from 
ANC12 DEM files. It uses the ANC13 file to detennine the geoid, ANC16/17 to calculate 
tides and ANC01 for meteorological infonnation. It uses ANC09 for precision attitude, and 
ANC04/ANC08 for precision orbit information. It uses ANC27 for regional mask information 
to define what data are placed on the regional products (GLA12-15). It uses ANC45 files to 
initialize metadata/header information. ANC25 and ANC33 files are used for time delay and 
oscillator-based corrections. ANC51 files contain the SRTM digital elevation information. 
ANC52 files are used for saturation corrections for range, energy, and pulse width in GLA06 
and GLA12-15. 

GLAS Alt should be run after successful execution of GLAS L1A, metutil, and (optionally) 
GLASAtm. GLAS Alt may be run all at once or in two separate executions: the first for 
wavefonn processing, the second for elevation processing. GLAS Alt permits multi-granule 
input/output files, input/output time selection, selected execution, and reprocessing. 

8.2 Input Files 

Table 8-1 lists the inputs files to GLAS Alt. Liles which are specific to GLAS Alt are docu- 
mented in this section. See the appropriate section of this document or the GLAS Data Prod- 
ucts Specifications Volumes for details. 
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Table 8-1 GLASAIt Inputs 


File Spec 

Type 

Source 

Short Description 

anc01*.dat 

Dynamic Ancillary 

met_util 

Meteorological subset files. 
Data sets at times before and 
after the time of the profile are 
interpolated to the time of the 
profile. 

anc04*.dat 

Dynamic Ancillary 

UTexas 

IERS Polar Motion and Earth 
Rotation Data File. 

anc07MD000.dat 

Static Ancillary 

Science Team 

Error file. 

anc07*_0001 .dat 

Static Ancillary 

Science Team 

Global constants file. 

anc07*_0003.dat 

Static Ancillary 

Science Team 

Waveform constants file. 
‘Waveform only 

anc07*_0004.dat 

Static Ancillary 

Science Team 

Elevations constant file. 
‘Elevation only 

anc08*.dat 

Dynamic Ancillary 

UTexas 

Precision Orbit file. 

anc09*.dat 

Dynamic Ancillary 

UTexas 

Precision Attitude file. 

anc12MD000.dat 

Static Ancillary 

Science Team 

Coarse DEM file 

anc12*_0001 .dat 

Static Ancillary 

Science Team 

Fine DEM file 

anc13*.dat 

Static Ancillary 

Science Team 

Geoid file 
‘Elevation only. 

anc16*.dat 

Static Ancillary 

Science Team 

Load tide coefficients file 
‘Elevation only. 

anc17*.dat 

Static Ancillary 

Science Team 

Ocean tide coefficients file 
‘Elevation only. 

anc25*.dat 

Dynamic Ancillary 

Science Team 

GPS/UTC conversion file. 

anc27*_0000.dat 

Static Ancillary 

Science Team 

Coarse regional mask file. 

anc27*_0001.dat 

Static Ancillary 

Science Team 

Fine regional mask file. 

anc33*.dat 

Dynamic Ancillary 

Science Team 

UTC time conversion file. 

anc41*.dat 

Dynamic Ancillary 

Science Team 

JPL Planetary Ephemeris 

anc45*_0001 .dat 

Static Ancillary 

Science Team 

GLA01 metadata input file. 
‘Waveform only 

anc45*_0005.dat 

Static Ancillary 

Science Team 

GLA05 metadata input file. 

anc45*_0006.dat 

Static Ancillary 

Science Team 

GLA06 metadata input file. 

anc45*_001 2.dat 

Static Ancillary 

Science Team 

GLA12 metadata input file. 

anc45*_001 3.dat 

Static Ancillary 

Science Team 

GLA13 metadata input file. 
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Table 8-1 GLASAIt Inputs (Continued) 


File Spec 

Type 

Source 

Short Description 

anc45*_001 4.dat 

Static Ancillary 

Science Team 

GLA14 metadata input file. 

anc45*_001 5.dat 

Static Ancillary 

Science Team 

GLA15 metadata input file. 

anc51*.dat 

Static Ancillary 

GSAS Internal 

SRTM DEM Data, ‘Elevation 
only 

anc52*_0001 .dat 

Static Ancillary 

Instrument Team 

Range Saturation Correction 
Table, ‘Elevation only 

anc52*_0002.dat 

Static Ancillary 

Instrument Team 

Energy Saturation Correction 
Table, ‘Elevation only 

anc52*_0003.dat 

Static Ancillary 

Instrument Team 

Pulse Width Saturation Correc- 
tion Table, ‘Elevation only 

Control File 

Control 

ISIPS Operations 

Control file. 

gla01*_.dat 

Level-IA Product 

GLAS_L1A 

LI A Altimetry product file. 
‘Waveform only. 

gla05*_.dat 

Level-1 B Product 

GLAS_Alt 

LI B Waveform product file. 
‘Elevation only 

gla09*_.dat 

Level-2 Product 

GLAS_Atm 

L2 Atmosphere product file. 
‘Optional-Elevation only 

glall ‘_.dat 

Level-2 Product 

GLAS_Atm 

L2 Atmosphere product file. 
‘Optional-Elevation only 

gla06*_.dat 

Level-1 B Product 

GLAS_Alt 

LI A Elevation product file. 
‘Elevation only 
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8.2.1 Control File 

The control file fonnat and common elements are documented in Section 5 of this document. 
Elements specific to GLASAlt are described here. 

The control file section delimiter for GLAS Alt is: 

=GLAS_Alt 

In order to satisfy the partial execution requirement, GLAS Alt can perform limited process- 
ing based on execution flags within the control file. The flags and the processes they control 
are defined in Table 8-2. 


Table 8-2 GLAS Alt Control Flags 


Flag 

Significance 

WAVEFORM_PROCESS=None 

Indicates that GLAS_Alt should perform no wave- 
form processing. 

WAVEFORM_PROCESS=AII 

Indicates that GLAS_Alt should perform waveform 
processing. 

WAVEFORM_OPTIONS=w_noLandCalc 

Indicates that GLAS_Alt should not process data 
using alternate parameters 

WAVEFORM_OPTIONS=w_noOtherCalc 

Indicates that GLAS_Alt should not process data 
using standard parameters 

WAVEFORM_OPTIONS=w_noGeo 

Indicates that GLAS_Alt should not compute lati- 
tude, longitude, or elevation, but, instead, will use 
pass-thru data from an input GLA05. This flag 
should only be used in a reprocessing scenario 
where a GLA05 is input. 

ELEVATION_PROCESS=None 

Indicates that GLAS_Alt should perform no eleva- 
tion processing. 

ELEVATION_PROCESS=E_CalcLoadTD 

Indicates the Load Tide computations should be 
performed. 

ELEVATION_PROCESS=E_CalcOceanTD 

Indicates the Ocean Tide computations should be 
performed. 

ELEVATION_PROCESS=E_CalcEarthTD 

Indicates the Earth Tide computations should be 
performed. 

ELEVATION_PROCESS=E_GetGeoid 

Indicates the Geoid computations should be per- 
formed. 

ELEVATION_PROCESS=E_CalcTrop 

Indicates the tropospheric computations should be 
performed. 

ELEVATION_PROCESS=E_lntrpPOD 

Indicates the POD computations should be per- 
formed. 

ELEVATION_PROCESS=E_CalcStdlR 

Indicates the standard range computations should 
be performed. 
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Table 8-2 GLAS_Alt Control Flags (Continued) 

Flag Significance 

ELEVATION_PROCESS=E_CalcLdlR Indicates the land-specific range computations 

should be performed. 

ELEVATION_PROCESS=E_CalcOclRc Indicates the ocean-specific range computations 

should be performed. 

ELEVATION_PROCESS=E_CalcSilR Indicates the sea ice-specific range computations 

should be performed. 

ELEVATION_PROCESS=E_CalclslR Indicates the ice sheet-specific range computations 

should be performed. 

ELEVATION_PROCESS=E_CalcSpLoc Indicates the spot location computations should be 

performed. 

ELEVATION_PROCESS=E_AtmQF Indicates the ATM Quality Flag should be used to 

generate the Elevations. 

ELEVATION_PROCESS=E_CalcSlope Indicates the slope computations should be per- 
formed. 

ELEVATION_PROCESS=E_CalcRefl Indicates the reflectance computations should be 

performed. 

ELEVATION_PROCESS=E_ChckReg Indicates the region-specific checks should be per- 

formed. 

ELEVATION_PROCESS=E_CalcRegRng Indicates the regional range computations should 

be performed. 

ELEVATION_PROCESS=E_CalcRegParm Indicates the region parameter computations should 

be performed. 

ELEVATION_PROCESS=E_CalcDEM Indicates the DEM computations should be per- 

formed. 

ELEVATION_PROCESS=E_Supress_SRT Indicates that GLAS_Alt should suppress STRM- 

M related processing (and avoids required input of 

STRMs). 

ELEVATION_PROCESS=ALL Indicates that GLAS_Alt should perform all elevation 

processing. 

Combinations of the execution flags are allowed. For example, to perform both waveform and 
elevation processing, the control file would have the following entries: 

WAVEFORM_PROCESS=ALL 

ELEVATION_PROCESS=ALL 

A control file option is available to designate that location infonnation be taken from the input 
data rather than the ANC04/08/09 geolocation file. This is useful for quick-look processing 
when the geolocation files are not yet available but should not be used for normal, production 
processing. In addition, this option is not very useful for elevation processing since elevation 
is highly location and range dependent. 
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To indicate that pass-thru processing should be used, add the following line to the control file: 
POS I T I ON= PAS S_THRU 

If this line is not included in the control file, geolocation processing will occur by default. 

8.3 Output Files 

Table 8-3 lists the outputs created by GLASAlt. See the appropriate section of this document 
or the GLAS Data Products Specifications Volumes for details regarding the output files 

Granule boundaries are designated by specifying start and stop times on the OUTPUT FILE 
control file entries. 


Table 8-3 GLAS Alt Outputs 


File Spec 

Type 

Destination 

Short Description 

gla05*.dat 

LIB Alt Product 

Archive/GLAS_Alt 

The level IB waveform parame- 
terization product file. Contains 
the output from the waveform 
characterization procedure and 
other parameters required to 
calculate surface slope and 
relief characteristics. 

gla06*.dat 

L2 Alt Product 

Archive/GLAS_Alt 

LIB elevation data product file. 
Contains the surface elevation, 
surface roughness assuming no 
slope, surface slope assuming 
no roughness and geodetic and 
atmospheric corrections for the 
range. 

gla12*.dat 

L2 Alt Product 

Archive 

L2 ice sheet altimetry product 
file. Contains the ice sheet ele- 
vation and elevation distribution 
calculated from algorithms fine- 
tuned for ice sheet returns. 

gla13*.dat 

L2 Alt Product 

Archive 

L2 sea ice altimetry product file. 
Contains the sea ice freeboard 
and sea ice roughness calcu- 
lated from algorithms fine-tuned 
for sea ice returns. 

gla14*.dat 

L2 Alt Product 

Archive 

L2 land altimetry product file. 
Contains the land elevation and 
land elevation distribution calcu- 
lated from algorithms fine-tuned 
for land returns. 
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Table 8-3 GLASAIt Outputs (Continued) 


File Spec 

Type 

Destination 

Short Description 

gla15*.dat 

L2 Alt Product 

Archive 

L2 ocean altimetry product file. 
Contains ocean elevation and 
small-scale roughness calcu- 
lated from algorithms fine-tuned 
for ocean returns. 

gla05*.qap 

LI B Alt Quality 

QA 

LIB waveform parameteriza- 
tion quality file. 

gla06*.qap 

L2 Alt Quality 

QA 

L2 elevation data quality file. 

gla12*.qap 

L2 Alt Quality 

QA 

L2 ice sheet altimetry quality 
file. 

gla13*.qap 

L2 Alt Quality 

QA 

L2 sea ice altimetry quality file. 

gla14*.qap 

L2 Alt Quality 

QA 

L2 land altimetry quality file. 

gla15*.qap 

L2 Alt Quality 

QA 

L2 ocean altimeter quality file. 

anc06*.txt 

Dynamic Ancillary 

ISIPS Operations 

Standard metadata/processing 
log file. 


Of importance is the relationship between the execution flags and the output products. If a 
particular execution flag is present in the control file, then the corresponding output file type 
must be present as well. Table 8-4 shows the relationship between output products and execu- 
tion flags These relationships will be more fully defined in the next section. 


Table 8-4 GLAS AIt Execution Flags and Output Products 


Execution Flag 

Required Output Product 

WAVEFORM_PROCESS=ALL 

gla05*.dat, gla05*.qap 

ELEVATION_PROCESS=ALL 

gla06*.dat, gla06*.qap, gla12*.dat, gla12*.qap, gla13*.dat, 
gla13*.qap, gla14*.dat, gla14*.qap, gla15*.dat, gla15*.qap 


8.4 Processing and Reprocessing Scenarios 

GLAS AIt supports full and partial processing and reprocessing scenarios. Control file entries 
are shown for each supported scenario defining the requisite execution flags as well as input 
and output files. Only those control file entries unique to the particular processing scenario are 
shown for brevity. Additionally, even though multiple files of the same time may be needed, a 
single instance is shown. 

Time-selected processing may also be perfonned by specifying specific start and stop times 
on the INPUT FILE and OUTPUT FILE control file entries. 
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8.4.1 Full Processing 

This scenario is used to create both waveform and elevation products from GLA01 and the 
requisite ANC files. All files listed in Table 8-1 and Table 8-3 are required. 

8.4.2 Partial Processing: Waveform Only 

This scenario is used to process only Waveform data, creating GLA05 data from selected 
GLA01 products and the requisite ANC files. All files listed in Table 8-1 and Table 8-3, 
except those listed as Elevation-only, are required. The following execution flag is required: 

WAVEFORM_PROCESS=ALL 

8.4.3 Partial Processing/Re-Processing: Elevation Only 

This scenario is used to process only Elevation data, creating GLA06 and GLA12-15 data 
from selected GLA05 products (created during a previous execution of GLAS Alt) and the 
requisite ANC files. All files listed in Table 8-1 and Table 8-3, except those listed as Wave- 
form-only, are required. The following execution flag is required: 

ELEVATION_PROCESS=ALL 

8.4.4 Predict Orbit Processing: Waveform Only 

This scenario is used to quickly process Waveform data when only predicted orbit (ANC20) is 
available. The input files listed in Table 8-5 are required. 


Table 8-5 GLAS Alt Predict Waveform Inputs 


File Spec 

Type 

Source 

Short Description 

anc07MD000.dat 

Static Ancillary 

Science Team 

Error file. 

anc07*_0001 .dat 

Static Ancillary 

Science Team 

Global constants file. 

anc07MD003.dat 

Static Ancillary 

Science Team 

Waveform constants file. 

anc20*.dat 

Dynamic Ancillary 

UTexas 

Predict Orbit file. 

anc25*.dat 

Dynamic Ancillary 

Science Team 

GPS/UTC conversion file. 

anc27*_0000.dat 

Static Ancillary 

Science Team 

Coarse regional mask file. 

anc27*_0001.dat 

Static Ancillary 

Science Team 

Fine regional mask file. 

anc33*.dat 

Dynamic Ancillary 

Science Team 

UTC time conversion file. 

anc45*_0001 .dat 

Static Ancillary 

Science Team 

GLA01 metadata input file. 
* Waveform only 

anc45*_0005.dat 

Static Ancillary 

Science Team 

GLA05 metadata input file. 

Control File 

Control 

ISIPS Operations 

Control file. 

glaOlVdat 

Level-IA Product 

GLAS_L1A 

LI A Altimetry product file. 
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8.4.5 Predict Orbit Processing: Elevation Only 

This scenario is used to quickly process Elevation data when only predicted orbit (ANC20) is 
available. The input files listed in Table 8-6 are required. 


Table 8-6 GLASAIt Predict Elevation Inputs 


File Spec 

Type 

Source 

Short Description 

anc07MD000.dat 

Static Ancillary 

Science Team 

Error file. 

anc07*_0001 .dat 

Static Ancillary 

Science Team 

Global constants file. 

anc07*_0004.dat 

Static Ancillary 

Science Team 

Elevations constant file. 

anc12MD000.dat 

Static Ancillary 

Science Team 

Coarse DEM file. 

anc12*_0001 .dat 

Static Ancillary 

Science Team 

Fine DEM file 

anc13*.dat 

Static Ancillary 

Science Team 

Geoid file 

anc16*.dat 

Static Ancillary 

Science Team 

Load tide coefficients file 

anc17*.dat 

Static Ancillary 

Science Team 

Ocean tide coefficients file 

anc20*.dat 

Dynamic Ancillary 

UTexas 

Predict Orbit file. 

anc25*.dat 

Dynamic Ancillary 

Science Team 

GPS/UTC conversion file. 

anc27MD000.dat 

Static Ancillary 

Science Team 

Coarse regional mask file. 

anc27MJ001.dat 

Static Ancillary 

Science Team 

Fine regional mask file. 

anc33*.dat 

Dynamic Ancillary 

Science Team 

UTC time conversion file. 

anc41*.dat 

Dynamic Ancillary 

Science Team 

JPL Planetary Ephemeris 

anc45*_0005.dat 

Static Ancillary 

Science Team 

GLA05 metadata input file. 

anc45*_0006.dat 

Static Ancillary 

Science Team 

GLA06 metadata input file. 

anc45*_001 2.dat 

Static Ancillary 

Science Team 

GLA12 metadata input file. 

anc45*_001 3.dat 

Static Ancillary 

Science Team 

GLA13 metadata input file. 

anc45*_001 4.dat 

Static Ancillary 

Science Team 

GLA14 metadata input file. 

anc45*_001 5.dat 

Static Ancillary 

Science Team 

GLA15 metadata input file. 

Control File 

Control 

ISIPS Operations 

Control file. 

gla05*_.dat 

Level-1 B Product 

GLAS_Alt 

LI B Waveform product file. 

gla09*_.dat 

Level-2 Product 

GLAS_Atm 

L2 Atmosphere product file. 
(* Optional) 

glair_.dat 

Level-2 Product 

GLAS_Atm 

L2 Atmosphere product file. 
(* Optional) 


The following control flags are required: 

WAVEFORM PROCESS=NONE 
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ELEVATION_PROCESS=E_IntrpPOD 

ELEVATION_PROCESS=E_CalcDEM 

ELEVATION_PROCESS=E_CalcSlope 

ELEVATION_PROCESS=E_CalcLoadTD 

ELEVATION_PROCESS=E_CalcOceanTD 

ELEVATION_PROCESS=E_CalcEarthTD 

ELEVATION_PROCESS=E_GetGeoid 

ELEVATION_PROCESS=E_Supress_STRM 

SURFACE_TYPE=ALL 

8.4.6 Re-Processing: Elevation Region-Specific Only 

This scenario is used to recreate the GLA12-15 region-specific products from a previously 
created GLA05/GLA06 and the requisite ANC files. All files listed in Table 8-1 and Table 8- 
3, except those listed as Waveform-only, are required, with the following exceptions: 

• GLA06 is required as an input but not an output. 

• Tide files (ANC 16, ANC 17) are not required. 

• The geoid file (ANC 13) is not required. 

• The meteorological files (ANC01) are not required. 

The following execution flags are required: 

ELEVATION_PROCESS=E_GetGeoid 

ELEVATION_PROCESS=E_IntrpPOD 

ELEVATION_PROCESS=E_CalcStdIR 

ELEVATION_PROCESS=E_CalcLdIR 

ELEVATION_PROCESS=E_CalcOcIR 

ELEVATION_PROCESS=E_CalcSiIR 

ELEVATION_PROCESS=E_CalcIsIR 

ELEVATION_PROCESS=E_CALCSpLoc 

ELEVATION_PROCESS=E_AtmQF 

ELEVATION_PROCESS=E_Cacl Slope 

ELEVATION_PROCESS=E_CalcRef 1 

ELEVATION_PROCESS=E_ChckReg 

ELEVATION_PROCESS=E_CalcRegRng 

ELEVATION_PROCESS=E_CalcRegParm 

ELEVATION_PROCESS=E_CalcDEM 

8.5 Startup and Termination 

This is an overview of the steps necessary to run GLAS_Alt. 

8.5.1 Setup a Runtime Directory 

The suggested method of running GLASAlt is to create a temporary directory and link all 
necessary files into it. The SDMS will create a temporary directory and link all necessary files 
into it. For example, to setup a GLAS Alt run, one would perform the following steps (Desig- 
nate TEMPDIR as the temporary directory and DATA DIR as the location in which input 
data for this job has been staged): 

mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/GLAS_Alt . 
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In -s $GLAS_HOME/lib/* . 

In -s $GLAS_HOM E/data/anc* .dat . 

In -s $DATA_DIR/*.dat . 

8.5.2 Create a Control File 

GLASAlt is designed to take the name of a control file as a command-line argument. The 
suggested method of creating a control file is by copying a template from the 
$GLAS_HOME/data directory and modifying it with desired input/output filenames and data 
processing options. 

cp $GLAS_HOME/data/cf_glas_alt_(w/fe/ev).ctl ./control Jilejiame 
vi ./control Jilejiame 

8.5.3 Run the PGE 

Error and status messages will be displayed on screen (stdout) and recorded in the ANC06 
file. 


./GLAS_Alt control Jilejiame 

8.5.4 Run-Time Statistics 

GLAS Alt processes 25 hours of GLAS data in approximately 12 hours for full wavefonn 
processing. GLAS Alt processes 25 hours of GLAS data in approximately 1.5 hours for full 
elevation processing. This may vary due to hardware load and data dependencies. 

8.5.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. The log/ 
metadata file (ANGOLA) must be examined to determine runtime success. Additionally, the 
process will return a result code to the operating system which may be used to programatically 
detennine success or failure (0=success, 3=fatal error). 

8.6 Error and Warning Messages 

All GSAS error and warning messages are numerically listed in Appendix D. 

8.7 Recovery Steps 

If GLAS Alt terminates with an error: 

1) Review error and status messages in the ANC06 file or on stdout to detennine 
source or location of problem. Refer to errors listed in Appendix D for assistance in 
detennining the problem. 

2) Correct the problem 

3) Remove previous output files 

4) Re-run the software 

In case of a problematic error, which cannot be easily diagnosed, debug versions of 
GLAS Alt will be available for test use. This is, however, more of a developer procedure than 
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a user procedure. Software users should contact the GSAS Development Team for more 
instructions. 

8.8 Sample GLAS_Alt Waveform Control File 

=GLAS_Alt 
PGE_VERSION=5 . 0 

PASSID=3 944 21030011101 118564084 118569884 25.45729 4123 
PASSID=3 94 5 21030011102 118569884 118575683 1.2635106 4124 

# granule_id = 6489200 

INPUT_FILE=ANC04_005_20031003_235947_02_0001 . DAT 118497587 118583987 

# granule_id = 7309164 

INPUT_F I LE =GLA0 1_0 2 4_2 1 0 3_0 0 1_1 1 0 1_4_0 1_0 0 01. DAT 118569075 118570691 24 1 4 

# granule_id = 7295559 
INPUT_FILE=anc07_024_01_0000 . dat 0 0 
INPUT_FILE=anc07_024_01_0001 . dat 0 0 
INPUT_FILE=anc07_024_01_0002 . dat 0 0 
INPUT_FILE=anc07_024_01_0003 .dat 0 0 
INPUT_FILE=anc07_024_01_0004 . dat 0 0 
INPUT_FILE=anc07_024_01_0005 . dat 0 0 
INPUT_FILE=anc07_024_01_0006 . dat 0 0 

# granule_id = 6489212 

INPUT_FILE=ANC08_006_20031003_235947_01_0001 . DAT 118497587 118583987 

# granule_id = 6890571 

INPUT_FILE=ANC09_015_20031003_235947_01_0001 . DAT 118497587 118583987 

# granule_id = 6074352 
INPUT_FILE=ancl2_004_01_0000 . dat 0 0 
INPUT_FILE=ancl2_004_01_0001 . dat 0 0 

# granule_id = 40170 

INPUT_FILE=anc25_001_20021213_000000_01_0000,dat 0 0 

# granule_id = 7615 

INPUT_FILE=anc27_001_01_0000 . dat 0 0 
INPUT_FILE=anc27_001_01_0001 .dat 0 0 

# granule_id = 7266774 

INPUT_FILE=ANC33_001_20050915_000000_01_0000 . DAT 0 0 

# granule_id = 139831 
INPUT_FILE=anc41_009_01_0000 . dat 0 0 

# granule_id = 7291335 
INPUT_FILE=anc45_024_01_0001 . dat 0 0 
INPUT_FILE=anc45_024_01_0002 .dat 0 0 
INPUT_FILE=anc45_024_01_0003 . dat 0 0 
INPUT_FILE=anc45_024_01_0004 . dat 0 0 
INPUT_FILE=anc45_024_01_0005 . dat 0 0 
INPUT_FILE=anc45_024_01_0006 . dat 0 0 
INPUT_FILE=anc45_024_01_0007 . dat 0 0 
INPUT_FILE=anc45_024_01_0008 . dat 0 0 
INPUT_FILE=anc45_024_01_0009 . dat 0 0 
INPUT_FILE=anc45_024_01_0010 . dat 0 0 
INPUT_FILE=anc45_024_01_0011 . dat 0 0 
INPUT_FILE=anc45_024_01_0012 . dat 0 0 
INPUT_FILE=anc45_024_01_0013 . dat 0 0 
INPUT_FILE=anc45_024_01_0014 . dat 0 0 
INPUT_FILE=anc45_024_01_0015 . dat 0 0 

# granule_id = 7309849 

OUTPUT_FILE=GLA0 5_024_2 103_0 0 1_1101_4_0 1_0 0 01. DAT 118569075 118570691 24 1 4 

# granule_id = 7309850 

OUTPUT_FI LE=GLA0 5_0 2 4_2 103_001_110 1_4_0 1_0 0 01. QAP 118569075 118570691 24 1 4 


Version 7.0 


Page 8-12 


March 2013 



GLAS Alt 


The GLAS Science Algorithm Software (GSAS) User’s Guide 


OUTPUT_FILE=ANCO 6_024_2 0 05 1 019_4 6 7734_0 l_GLAS__Alt . txt 0 0 

WAVEFORM_PROCESS=ALL 

ELEVATION_PROCESS=NONE 

8.9 Sample GLAS_Alt Elevation Control File 

=GLAS_Alt 

PGE_VERSION=ACC 

PASSID=6127 21070020085 131223570 131229369 127.56509 3107 
PASSID=6128 21070020086 131229369 131235169 103.36963 3108 
PASSID=612 9 21070020087 131235169 131240968 79.17347 3109 
PASSID=613 0 21070020088 131240968 131246767 54.9781 3110 
PASSID=6131 21070020089 131246767 131252566 30.783556 3111 
PASSID=6132 21070020090 131252566 131258365 6.589782 3112 
PASSID=6133 21070020091 131258365 131264164 -17.603912 3113 
PASSID=6134 21070020092 131264164 131269963 -41.798492 3114 
PASSID=6135 21070020093 131269963 131275762 -65.99344 3115 
PASSID=6136 21070020094 131275762 131281561 -90.187225 3116 
PASSID=6137 21070020095 131281561 131287360 -114.38165 3117 
PASSID=6138 21070020096 131287360 131293159 -138.57704 3118 
PASSID=6139 21070020097 131293159 131298958 -162.77257 3119 
PASSID=614 0 21070020098 131298958 131304757 173.03156 3120 
PASSID=6141 21070020099 131304757 131310556 148.83627 3121 

# granule_id = 7558395 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 5_1_01_0 0 01. DAT 131224377 131225658 532 1 1 

# granule_id = 7558397 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 5_2_01_0 0 01. DAT 131225658 131227274 532 1 2 

# granule_id = 7558399 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 5_3_01_0 0 01. DAT 131227274 131228561 532 1 3 

# granule_id = 7558401 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 5_4_01_0 0 01. DAT 131228561 131230177 532 1 4 

# granule_id = 7558403 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 6_1_01_0 0 01. DAT 131230177 131231457 532 1 1 

# granule_id = 7558405 

INPUT_FILE=GLA0 5_53 2_2 1 0 7_0 02_0 0 8 6_2_0 1_0 0 01. DAT 131231457 131233073 532 1 2 

# granule_id = 7558407 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 6_3_01_0 0 01. DAT 131233073 131234360 532 1 3 

# granule_id = 7558409 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 6_4_01_0 0 01. DAT 131234360 131235976 532 1 4 

# granule_id = 7558411 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 7_1_01_0 0 01. DAT 131235976 131237256 532 1 1 

# granule_id = 7558413 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 7_2_01_0 0 01. DAT 131237256 131238873 532 1 2 

# granule_id = 7558415 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 7_3_01_0 0 01. DAT 131238873 131240159 532 1 3 

# granule_id = 7558417 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 7_4_01_0 0 01. DAT 131240159 131241775 532 1 4 

# granule_id = 7558419 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 8_1_01_0 0 01. DAT 131241775 131243055 532 1 1 

# granule_id = 7558421 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 8_2_01_0 0 01. DAT 131243055 131244672 532 1 2 

# granule_id = 7558423 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 8_3_01_0 0 01. DAT 131244672 131245958 532 1 3 

# granule_id = 7558425 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 8_4_01_0 0 01. DAT 131245958 131247574 532 1 4 

# granule_id = 7558427 

INPUT_FILE=GLA05_532_2107_002_0089_1_01_0001 .DAT 131247574 131248854 532 1 1 

# granule_id = 7558429 
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INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 9_2 

# granule_id = 7558431 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 9_3 

# granule_id = 7558433 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 8 9_4 

# granule_id = 7558435 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 90_1 

# granule_id = 7558437 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 90_2 

# granule_id = 7558439 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 90_3 

# granule_id = 7558441 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 90_4 

# granule_id = 7558443 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 91_1 

# granule_id = 7558445 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 91_2 

# granule_id = 7558447 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 91_3 

# granule_id = 7558449 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 91_4 

# granule_id = 7558451 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 92_1 

# granule_id = 7558453 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 92_2 

# granule_id = 7558455 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 92_3 

# granule_id = 7558457 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 92_4 

# granule_id = 7558459 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 93_1 

# granule_id = 7558461 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 93_2 

# granule_id = 7558463 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 93_3 

# granule_id = 7558465 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 93_4 

# granule_id = 7558467 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 94_1 

# granule_id = 7558469 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 94_2 

# granule_id = 7558471 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 94_3 

# granule_id = 7558473 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 94_4 

# granule_id = 7558475 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 95_1 

# granule_id = 7558477 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 95_2 

# granule_id = 7558479 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 95_3 

# granule_id = 7558481 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 95_4 

# granule_id = 7558483 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 96_1 

# granule_id = 7558485 
INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 96_2 

# granule_id = 7558487 

INPUT FILE=GLA05 532 2107 002 0096 3 


_ 01 _ 

0001. DAT 

131248854 

131250471 

532 

_ 01 _ 

0001. DAT 

131250471 

131251757 

532 

_ 01 _ 

0001. DAT 

131251757 

131253373 

532 

_ 01 _ 

0001. DAT 

131253373 

131254653 

532 

_ 01 _ 

0001. DAT 

131254653 

131256270 

532 

_ 01 _ 

0001. DAT 

131256270 

131257556 

532 

_ 01 _ 

0001. DAT 

131257556 

131259172 

532 

_ 01 _ 

0001. DAT 

131259172 

131260452 

532 

_ 01 _ 

0001. DAT 

131260452 

131262068 

532 

_ 01 _ 

0001. DAT 

131262068 

131263355 

532 

_ 01 _ 

0001. DAT 

131263355 

131264971 

532 

_ 01 _ 

0001. DAT 

131264971 

131266251 

532 

_ 01 _ 

0001. DAT 

131266251 

131267867 

532 

_ 01 _ 

0001. DAT 

131267867 

131269154 

532 

_ 01 _ 

0001. DAT 

131269154 

131270770 

532 

_ 01 _ 

0001. DAT 

131270770 

131272050 

532 

_ 01 _ 

0001. DAT 

131272050 

131273667 

532 

_ 01 _ 

0001. DAT 

131273667 

131274953 

532 

_ 01 _ 

0001. DAT 

131274953 

131276569 

532 

_ 01 _ 

0001. DAT 

131276569 

131277849 

532 

_ 01 _ 

0001. DAT 

131277849 

131279466 

532 

_ 01 _ 

0001. DAT 

131279466 

131280752 

532 

_ 01 _ 

0001. DAT 

131280752 

131282368 

532 

_ 01 _ 

0001. DAT 

131282368 

131283649 

532 

_ 01 _ 

0001. DAT 

131283649 

131285265 

532 

_ 01 _ 

0001. DAT 

131285265 

131286551 

532 

_ 01 _ 

0 0 01. DAT 

131286551 

131288167 

532 

_ 01 _ 

0 0 01. DAT 

131288167 

131289448 

532 

_ 01 _ 

0001. DAT 

131289448 

131291064 

532 

01 

0001. DAT 

131291064 

131292350 

532 


1 2 
1 3 
1 4 
1 1 
1 2 
1 3 
1 4 
1 1 
1 2 
1 3 
1 4 
1 1 
1 2 
1 3 
1 4 
1 1 
1 2 
1 3 
1 4 
1 1 
1 2 
1 3 
1 4 
1 1 
1 2 
1 3 
1 4 
1 1 
1 2 
1 3 
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# granule_id = 7558489 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 96_4_01_0 0 01. DAT 131292350 131293966 532 1 4 

# granule_id = 7558491 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 97_1_01_0 0 01. DAT 131293966 131295247 532 1 1 

# granule_id = 7558493 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 97_2_01_0 0 01. DAT 131295247 131296863 532 1 2 

# granule_id = 7558495 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 97_3_01_0 0 01. DAT 131296863 131298150 532 1 3 

# granule_id = 7558497 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 97_4_01_0 0 01. DAT 131298150 131299765 532 1 4 

# granule_id = 7558499 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 98_1_01_0 0 01. DAT 131299765 131301046 532 1 1 

# granule_id = 7558501 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_00 98_2_01_0 0 01. DAT 131301046 131302662 532 1 2 

# granule_id = 7558503 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_0 0 98_3_01_0 0 01. DAT 131302662 131303949 532 1 3 

# granule_id = 7558505 

INPUT_FILE=GLA05_532_2 1 0 7_0 02_00 98_4_01_0 0 01. DAT 131303949 131305564 532 1 4 

# granule_id = 7559242 

INPUT_FILE=GLAO 9_532_2 1 0 7_0 02_0 0 8 5_0_01_0 0 01. DAT 131224377 131305564 532 1 0 

# granule_id = 7559244 

INPUT_FILE=GLA11_532_2 1 0 7_0 02_0 0 8 5_0_01_0 0 01. DAT 131224377 131305564 532 1 0 

# granule_id = 7552729 

INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_0 0 0 0 0 0_01_0 0 0 0. DAT 131198400 131241600 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_0 0 0 0 0 0_01_0 0 01. DAT 131198400 131241600 
INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_0 0 0 0 0 0_01_0 0 02. DAT 131198400 131241600 
INPUT_FILE=ANC01_005_2 0 04 022 8_00 0 0 0 0_01_0 0 03. DAT 131198400 131241600 
INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_0 0 0 0 0 0_01_0 0 04. DAT 131198400 131241600 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_00 0 0 0 0_01_0 0 05. DAT 131198400 131241600 
INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_0 0 0 0 0 0_01_0 0 0 6. DAT 131198400 131241600 
INPUT_FILE=ANCO 1_005_2 0 04 022 8_0 0 0 0 0 0_01_0 0 0 7. DAT 131198400 131241600 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_0 0 0 0 0 0_01_0 0 0 8. DAT 131198400 131241600 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_0 0 0 0 0 0_01_0 0 0 9. DAT 131198400 131241600 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_0 0 0 0 0 0_01_0 010 . DAT 131198400 131241600 

# granule_id = 7552730 

INPUT_FILE=ANC01_0 05_2 0 04 022 8_0 6 0 0 0 0_01_0 0 0 0. DAT 131220000 131263200 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_0 6 0 0 0 0_01_0 0 01. DAT 131220000 131263200 
INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_0 6 0 0 0 0_01_0 0 02. DAT 131220000 131263200 
INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_0 6 0 0 0 0_01_0 0 03. DAT 131220000 131263200 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_0 6 0 0 0 0_01_0 0 04. DAT 131220000 131263200 
INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_0 6 0 0 0 0_01_0 0 05. DAT 131220000 131263200 
INPUT_FILE=ANCO 1_005_2 0 04 022 8_0 6 0 0 0 0_01_0 0 0 6. DAT 131220000 131263200 
INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_0 6 0 0 0 0_01_0 0 0 7. DAT 131220000 131263200 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_0 6 0 0 0 0_01_0 0 0 8. DAT 131220000 131263200 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_0 6 0 0 0 0_01_0 0 0 9. DAT 131220000 131263200 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_0 6 0 0 0 0_01_0 010 . DAT 131220000 131263200 

# granule_id = 7552731 

INPUT_FILE=ANC01_0 05_2 0 04 022 8_12 0 0 0 0_01_0 0 0 0. DAT 131241600 131284800 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_12 0 0 0 0_01_0 0 01. DAT 131241600 131284800 
INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_12 0 0 0 0_01_0 0 02. DAT 131241600 131284800 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_12 0 0 0 0_01_0 0 03. DAT 131241600 131284800 
INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_12 0 0 0 0_01_0 0 04. DAT 131241600 131284800 
INPUT_FILE=ANCO 1_005_2 0 04 022 8_12 0 0 0 0_01_0 0 05. DAT 131241600 131284800 
INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_12 0 0 0 0_01_0 0 0 6. DAT 131241600 131284800 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_12 0 0 0 0_01_0 0 0 7. DAT 131241600 131284800 
INPUT_FILE=ANCO 1_0 05_2 0 04 022 8_12 0 0 0 0_01_0 0 0 8. DAT 131241600 131284800 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_12 0 0 0 0_01_0 0 0 9. DAT 131241600 131284800 
INPUT FILE=ANC01 005 20040228 120000 01 0010.DAT 131241600 131284800 


# granule_id = 7552737 
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INPUT_FILE=ANC01_0 05_2 0 04 022 8_18 0 0 0 0_01_0 0 0 0. DAT 131263200 131306400 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_18 0 0 0 0_01_0 0 01. DAT 131263200 131306400 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_18 0 0 0 0_01_0 0 02. DAT 131263200 131306400 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_18 0 0 0 0_01_0 0 03. DAT 131263200 131306400 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_18 0 0 0 0_01_0 0 04. DAT 131263200 131306400 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_18 0 0 0 0_01_0 0 05. DAT 131263200 131306400 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_18 0 0 0 0_01_0 0 06. DAT 131263200 131306400 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_18 0 0 0 0_01_0 0 0 7. DAT 131263200 131306400 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_18 0 0 0 0_01_0 0 0 8. DAT 131263200 131306400 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_18 0 0 0 0_01_0 0 0 9. DAT 131263200 131306400 
INPUT_FILE=ANC01_0 05_2 0 04 022 8_18 0 0 0 0_01_0 010 . DAT 131263200 131306400 

# granule_id = 7552739 

INPUT_FILE=ANC01_0 05_2 0 04 022 9_0 0 0 0 0 0_01_0 0 0 0. DAT 131284800 131328000 
INPUT_FILE=ANC01_0 05_2 0 04 022 9_0 0 0 0 0 0_01_0 0 01. DAT 131284800 131328000 
INPUT_FILE=ANC01_0 05_2 0 04 022 9_0 0 0 0 0 0_01_0 0 02. DAT 131284800 131328000 
INPUT_FILE=ANC01_0 05_2 0 04 022 9_0 0 0 0 0 0_01_0 0 03. DAT 131284800 131328000 
INPUT_FILE=ANC01_0 05_2 0 04 022 9_0 0 0 0 0 0_01_0 0 04. DAT 131284800 131328000 
INPUT_FILE=ANC01_005_20040229_000000_01_0005 .DAT 131284800 131328000 
INPUT_FILE=ANC01_0 05_2 0 04 022 9_0 0 0 0 0 0_01_0 0 06. DAT 131284800 131328000 
INPUT_FILE=ANC01_0 05_2 0 04 022 9_0 0 0 0 0 0_01_0 0 0 7. DAT 131284800 131328000 
INPUT_FILE=ANC01_0 05_2 0 04 022 9_0 0 0 0 0 0_01_0 0 0 8. DAT 131284800 131328000 
INPUT_FILE=ANC01_0 05_2 0 04 022 9_0 0 0 0 0 0_01_0 0 0 9. DAT 131284800 131328000 
INPUT_FILE=ANC01_0 05_2 0 04 022 9_0 0 0 0 0 0_01_0 010 . DAT 131284800 131328000 

# granule_id = 7253571 

INPUT_FILE=ANC04_0 06_2 0 04 0227_23 594 7_01_0 0 01. DAT 131198387 131284787 

# granule_id = 7254216 

INPUT_FILE=ANC04_0 06_2 0 04 022 8_23 594 7_01_0 0 01. DAT 131284787 131371187 

# granule_id = 7509819 
INPUT_FILE=anc07_026_01_0000 . dat 0 0 
INPUT_FILE=anc07_026_01_0001 . dat 0 0 
INPUT_FILE=anc07_026_01_0002 .dat 0 0 
INPUT_FILE=anc07_026_01_0003 . dat 0 0 
INPUT_FILE=anc07_026_01_0004 . dat 0 0 
INPUT_FILE=anc07_026_01_0005 . dat 0 0 
INPUT_FILE=anc07_026_01_0006 . dat 0 0 

# granule_id = 7253574 

INPUT_FILE=ANCO 8_0 08_2 0 04 0227_23 594 7_01_0 0 01. DAT 131198387 131284787 

# granule_id = 7254218 

INPUT_FILE=ANCO 8_0 08_2 0 04 022 8_23 594 7_01_0 0 01. DAT 131284787 131371187 

# granule_id = 7558141 

INPUT_FILE=ANCO 9_94 0_2 0 04 0227_23 594 7_01_0 0 01. DAT 131198387 131284787 

# granule_id = 7558144 

INPUT_FILE=ANCO 9_94 0_2 0 04 022 8_23 594 7_01_0 0 01. DAT 131284787 131371187 

# granule_id = 6074352 
INPUT_FILE=ancl2_004_01_0000 . dat 0 0 
INPUT_FILE=ancl2_004_01_0001 . dat 0 0 

# granule_id = 6459833 
INPUT_FILE=ancl3_005_01_0000 . dat 0 0 

# granule_id = 7963 

INPUT_FILE=ancl6_001_01_0000 .dat 0 0 

# granule_id = 7964 

INPUT_FILE=ancl7_001_01_0000 .dat 0 0 

# granule_id = 7466720 

INPUT_FILE=anc2 5_0 0 1_2 0 0512 3 1_0 0 0 0 0 0_0 1_0 0 0 0. dat 0 0 

# granule_id = 7615 

INPUT_FILE=anc27_001_01_0000 .dat 0 0 
INPUT FILE=anc27 001 01 0001.dat 0 0 


# granule_id = 7328803 

INPUT FILE=ANC3 3 001 20051020 000000 01 0000.DAT 0 0 
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# granule_id = 139831 
INPUT_FILE=anc41_009_01_0000 . dat 0 0 

# granule_id = 7509820 
INPUT_FILE=anc45_026_01_0001 .dat 0 0 
INPUT_FILE=anc45_026_01_0002 . dat 0 0 
INPUT_FILE=anc45_026_01_0003 .dat 0 0 
INPUT_FILE=anc45_026_01_0004 . dat 0 0 
INPUT_FILE=anc45_026_01_0005 .dat 0 0 
INPUT_FILE=anc45_026_01_0006 .dat 0 0 
INPUT_FILE=anc45_026_01_0007 . dat 0 0 
INPUT_FILE=anc45_026_01_0008 . dat 0 0 
INPUT_FILE=anc45_026_01_0009 . dat 0 0 
INPUT_FILE=anc45_026_01_0010 . dat 0 0 
INPUT_FILE=anc45_026_01_0011 . dat 0 0 
INPUT_FILE=anc45_026_01_0012 .dat 0 0 
INPUT_FILE=anc45_026_01_0013 . dat 0 0 
INPUT_FILE=anc45_026_01_0014 . dat 0 0 
INPUT_FILE=anc45_026_01_0015 .dat 0 0 

# granule_id = 7222880 
INPUT_FILE=anc51_001_01_3107 . dat 0 0 
INPUT_FILE=anc51_001_01_3108 .dat 0 0 
INPUT_FILE=anc51_001_01_3109 .dat 0 0 
INPUT_FILE=anc51_001_01_3110 . dat 0 0 
INPUT_FILE=anc51_001_01_3111 . dat 0 0 
INPUT_FILE=anc51_001_01_3112 . dat 0 0 
INPUT_FILE=anc51_001_01_3113 .dat 0 0 
INPUT_FILE=anc51_001_01_3114 . dat 0 0 
INPUT_FILE=anc51_001_01_3115 .dat 0 0 
INPUT_FILE=anc51_001_01_3116 .dat 0 0 
INPUT_FILE=anc51_001_01_3117 . dat 0 0 
INPUT_FILE=anc51_001_01_3118 . dat 0 0 
INPUT_FILE=anc51_001_01_3119 . dat 0 0 
INPUT_FILE=anc51_001_01_3120 .dat 0 0 
INPUT_FILE=anc51_001_01_3121 .dat 0 0 

# granule_id = 7509822 
INPUT_FILE=anc52_002_01_0001 . dat 0 0 
INPUT_FILE=anc52_002_0 1_0002 .dat 0 0 
INPUT_FILE=anc52_002_01_0003 . dat 0 0 

# granule_id = 7559716 

OUTPUT_FILE=GLAO 6_532_2 107_0 02_0 0 85_1_0 1_0 0 01. DAT 131224377 131225658 532 1 1 

# granule_id = 7559718 

OUTPUT_FILE=GLAO 6_532_2 107_0 02_0 0 85_2_0 1_0 0 01. DAT 131225658 131227274 532 1 2 

# granule_id = 7559720 

OUTPUT_FILE=GLAO 6_532_2 107_0 02_0 0 85_3_0 1_0 0 01. DAT 131227274 131228561 532 1 3 

# granule_id = 7559722 

OUTPUT_FILE=GLAO 6_532_2 107_0 02_0 0 85_4_0 1_0 0 01. DAT 131228561 131230177 532 1 4 

# granule_id = 7559724 

OUTPUT_FILE=GLAO 6_532_2 107_0 02_0 0 86_1_0 1_0 0 01. DAT 131230177 131231457 532 1 1 

# granule_id = 7559726 

OUTPUT_FI LE=GLA0 6_5 3 2_2 107_002_008 6_2_0 1_0 0 01. DAT 131231457 131233073 532 1 2 

# granule_id = 7559728 

OUTPUT_FILE=GLAO 6_532_2 107_0 02_0 0 86_3_0 1_0 0 01. DAT 131233073 131234360 532 1 3 

# granule_id = 7559730 

OUTPUT_FI LE=GLA0 6_5 3 2_2 107_002_008 6_4_0 1_0 0 01. DAT 131234360 131235976 532 1 4 

# granule_id = 7559732 

OUTPUT_FILE=GLAO 6_532_2 107_0 02_0 0 87_1_0 1_0 0 01. DAT 131235976 131237256 532 1 1 

# granule_id = 7559734 

OUTPUT_FILE=GLAO 6_532_2 107_0 02_0 0 87_2_0 1_0 0 01. DAT 131237256 131238873 532 1 2 

# granule_id = 7559736 
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OUTPUT_FILE=GLA06_532_2 

# granule_id = 7559738 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559740 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559742 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559744 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559746 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559748 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559750 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559752 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559754 
OUTPUT_FILE=GLA06_532_2 

# granule_id = 7559756 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559758 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559760 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559762 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559764 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559766 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559768 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559770 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559772 
OUTPUT_FILE=GLA06_532_2 

# granule_id = 7559774 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559776 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559778 
OUTPUT_FILE=GLA06_532_2 

# granule_id = 7559780 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559782 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559784 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559786 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559788 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559790 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559792 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559794 
OUTPUT FILE=GLA06 532 2 


107_002_0087_3_01_0001 
107_002_0087_4_01_0001 
107_002_0088_1_01_0001 
107_002_0088_2_01_0001 
107_002_0088_3_01_0001 
107_002_0088_4_01_0001 
107_002_0089_1_01_0001 
107_002_0089_2_01_0001 
107_002_0089_3_01_0001 
107_002_0089_4_01_0001 
107_002_0090_1_01_0001 
107_002_0090_2_01_0001 
107_002_0090_3_01_0001 
107_002_0090_4_01_0001 
107_002_0091_1_02_0001 
107_002_0091_2_01_0001 
107_002_0091_3_01_0001 
107_002_0091_4_01_0001 
107_002_0092_1_01_0001 
107_002_0092_2_01_0001 
107_002_0092_3_01_0001 
107_002_0092_4_01_0001 
107_002_0093_1_01_0001 
107_002_0093_2_01_0001 
107_002_0093_3_01_0001 
107_002_0093_4_01_0001 
107_002_0094_1_01_0001 
107_002_0094_2_01_0001 
107_002_0094_3_01_0001 
107 002 0094 4 01 0001 


DAT 

131238873 

131240159 

DAT 

131240159 

131241775 

DAT 

131241775 

131243055 

DAT 

131243055 

131244672 

DAT 

131244672 

131245958 

DAT 

131245958 

131247574 

DAT 

131247574 

131248854 

DAT 

131248854 

131250471 

DAT 

131250471 

131251757 

DAT 

131251757 

131253373 

DAT 

131253373 

131254653 

DAT 

131254653 

131256270 

DAT 

131256270 

131257556 

DAT 

131257556 

131259172 

DAT 

131259172 

131260452 

DAT 

131260452 

131262068 

DAT 

131262068 

131263355 

DAT 

131263355 

131264971 

DAT 

131264971 

131266251 

DAT 

131266251 

131267867 

DAT 

131267867 

131269154 

DAT 

131269154 

131270770 

DAT 

131270770 

131272050 

DAT 

131272050 

131273667 

DAT 

131273667 

131274953 

DAT 

131274953 

131276569 

DAT 

131276569 

131277849 

DAT 

131277849 

131279466 

DAT 

131279466 

131280752 

DAT 

131280752 

131282368 


532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
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# granule_id = 7559796 


OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 5_1_0 1_0 0 01. DAT 

131282368 

131283649 

532 

# granule id = 7559798 

OUTPUT_FILE=GLAO 6_532_2107_002_009 5_2_0 1_0 0 0 1 . DAT 

131283649 

131285265 

532 

# granule id = 7559800 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 5_3_0 1_0 0 01. DAT 

131285265 

131286551 

532 

# granule id = 7559802 

OUTPUT_FILE=GLAO 6_532_2107_002_009 5_4_0 10 0 0 1 . DAT 

131286551 

131288167 

532 

# granule id = 7559804 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 6_1_0 10 0 01. DAT 

131288167 

131289448 

532 

# granule id = 7559806 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 0 2_0 0 9 6_2_0 1_0 0 0 1 . DAT 

131289448 

131291064 

532 

# granule id = 7559808 

OUTPUT_FILE=GLAO 6_532_2 107_0 02_0 0 96_3_0 1_0 0 01. DAT 

131291064 

131292350 

532 

# granule id = 7559810 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 0 2_0 0 9 6_4_0 1_0 0 0 1 . DAT 

131292350 

131293966 

532 

# granule id = 7559812 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 7_1_0 1_0 0 01. DAT 

131293966 

131295247 

532 

# granule id = 7559814 

OUTPUT_FILE=GLAO 6_532_2107_002_009 7_2_0 1_0 0 0 1 . DAT 

131295247 

131296863 

532 

# granule_id = 7559816 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 7_3_0 1_0 0 01. DAT 

131296863 

131298150 

532 

# granule id = 7559818 

OUTPUT_FILE=GLA06_532_2107_002_0097_4_01 0001.DAT 

131298150 

131299765 

532 

# granule id = 7559820 

OUTPUT_FILE=GLA06_532_2107_002_0098_1_01 0001.DAT 

131299765 

131301046 

532 

# granule id = 7559822 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 0 2_0 0 9 8_2_0 1_0 0 0 1 . DAT 

131301046 

131302662 

532 

# granule id = 7559824 

OUTPUT_FILE=GLAO 6_532_2 107_0 02_0 0 9 8_3_0 1_0 0 01. DAT 

131302662 

131303949 

532 

# granule id = 7559827 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 8_4_0 1 0001.DAT 

131303949 

131305564 

532 

# granule id = 7559708 

OUTPUT_FILE=GLA12_532_2 107_0 02_0 0 85_0_0 1_0 0 01. DAT 

131224377 

131305564 

532 

# granule id = 7559709 

OUTPUT_FILE=GLA13_532_2 107_0 02_0 0 85_0_0 1_0 0 01. DAT 

131224377 

131305564 

532 

# granule id = 7559710 

OUTPUT_FILE=GLA14_532_2 107_0 02_0 0 85_0_0 1_0 0 01. DAT 

131224377 

131305564 

532 

# granule id = 7559711 

0UTPUT_FILE=GLA1 5_5 3 2_2 1 0 7_0 02_0 0 8 5_0_0 1_0 0 01. DAT 

131224377 

131305564 

532 

# granule id = 7559717 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 0 2_0 0 8 5_1_0 1_0 0 01. QAP 

131224377 

131225658 

532 

# granule id = 7559719 

OUTPUT_FILE=GLAO 6_532_2107_002_008 5_2_0 1_0 0 0 1 . QAP 

131225658 

131227274 

532 

# granule id = 7559721 

OUTPUT_FILE=GLA06_532_2107_002_0085_3_01_0001 .QAP 

131227274 

131228561 

532 

# granule id = 7559723 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 8 5_4_0 1 0 0 01. QAP 

131228561 

131230177 

532 

# granule id = 7559725 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 8 6_1_0 1_0 0 01. QAP 

131230177 

131231457 

532 

# granule id = 7559727 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 8 6_2_0 10 0 01. QAP 

131231457 

131233073 

532 

# granule id = 7559729 

OUTPUT_FILE=GLA06_532_2107_002_0086_3_01_0001 . QAP 

131233073 

131234360 

532 

# granule id = 7559731 

OUTPUT_FILE=GLA06_532_2107_002_0086_4_01 0001 .QAP 

131234360 

131235976 

532 

# granule_id = 7559733 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 8 7_1_0 10 0 01. QAP 

131235976 

131237256 

532 


# granule_id = 7559735 


1 1 
1 2 
1 3 
1 4 
1 1 
1 2 
1 3 
1 4 
1 1 
1 2 
1 3 
1 4 
1 1 
1 2 
1 3 
1 4 
1 0 
1 0 
1 0 
1 0 
1 1 
1 2 
1 3 
1 4 
1 1 
1 2 
1 3 
1 4 
1 1 
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OUTPUT_FILE=GLAO 6_53 2 

# granule_id = 7559737 
OUTPUT_FILE=GLAO 6_5 3 2_ 

# granule_id = 7559739 
OUTPUT_FILE=GLAO 6_5 3 2_ 

# granule_id = 7559741 
OUTPUT_FILE=GLAO 6_5 3 2_ 

# granule_id = 7559743 
OUTPUT_FILE=GLA06_532_ 

# granule_id = 7559745 
OUTPUT_FILE=GLA06_532_ 

# granule_id = 7559747 
OUTPUT_FILE=GLA06_532_ 

# granule_id = 7559749 
OUTPUT_FILE=GLA06_532_ 

# granule_id = 7559751 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559753 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559755 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559757 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559759 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559761 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559763 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559765 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559767 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559769 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559771 
OUTPUT_FILE=GLA06_532_2 

# granule_id = 7559773 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559775 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559777 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559779 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559781 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559783 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559785 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559787 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559789 
OUTPUT_FILE=GLAO 6_5 3 2_2 

# granule_id = 7559791 
OUTPUT_FILE=GLAO 6_53 2_2 

# granule_id = 7559793 
OUTPUT FILE=GLA06 532 2 


2107 002 0087 2 01 0001 
2107 002 0087 3 01 0001 
2107 002 0087 4 01 0001 
2107 002 0088 1 01 0001 
2107 002 0088 2 01 0001 
2107 002 0088 3 01 0001 
2107 002 0088 4 01 0001 
2107_002_0089_1_01_0001 
107_002_0089_2_01_0001 
107_002_0089_3_01_0001 
107_002_0089_4_01_0001 
107_002_0090_1_01_0001 
107_002_0090_2_01_0001 
107_002_0090_3_01_0001 
107_002_0090_4_01_0001 
1 0 7_0 0 2_0 0 9 1_1_0 1_0 0 01 
1 0 7_0 0 2_0 0 9 1_2_0 1_0 0 01 
107_002_0091_3_01_0001 
107_002_0091_4_01_0001 
107_002_0092_1_01_0001 
107_002_0092_2_01_0001 
107_002_0092_3_01_0001 
107_002_0092_4_01_0001 
107_002_0093_1_01_0001 
107_002_0093_2_01_0001 
107_002_0093_3_01_0001 
107_002_0093_4_01_0001 
107_002_0094_1_01_0001 
107_002_0094_2_01_0001 
107 002 0094 3 01 0001 


QAP 

131237256 

131238873 

QAP 

131238873 

131240159 

QAP 

131240159 

131241775 

QAP 

131241775 

131243055 

QAP 

131243055 

131244672 

QAP 

131244672 

131245958 

QAP 

131245958 

131247574 

QAP 

131247574 

131248854 

QAP 

131248854 

131250471 

QAP 

131250471 

131251757 

QAP 

131251757 

131253373 

QAP 

131253373 

131254653 

QAP 

131254653 

131256270 

QAP 

131256270 

131257556 

QAP 

131257556 

131259172 

QAP 

131259172 

131260452 

QAP 

131260452 

131262068 

QAP 

131262068 

131263355 

QAP 

131263355 

131264971 

QAP 

131264971 

131266251 

QAP 

131266251 

131267867 

QAP 

131267867 

131269154 

QAP 

131269154 

131270770 

QAP 

131270770 

131272050 

QAP 

131272050 

131273667 

QAP 

131273667 

131274953 

QAP 

131274953 

131276569 

QAP 

131276569 

131277849 

QAP 

131277849 

131279466 

QAP 

131279466 

131280752 


532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
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# granule_id = 7559795 

OUTPUT_FILE=GLA06_532_2107_002_0094_4_01_0001 . QAP 

# granule_id = 7559797 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 5_1_0 10 0 01. QAP 

# granule_id = 7559799 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 5_2_0 10 0 01. QAP 

# granule_id = 7559801 

OUTPUT_FILE=GLA06_532_2107_002_0095_3_01_0001 . QAP 

# granule_id = 7559803 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 5_4_0 10 0 01. QAP 

# granule_id = 7559805 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 0 2_0 0 9 6_1_0 1_0 0 01. QAP 

# granule_id = 7559807 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 0 2_0 0 9 6_2_0 1_0 0 01. QAP 

# granule_id = 7559809 

OUTPUT_FILE=GLA06_532_2107_002_0096_3_01_0001 . QAP 

# granule_id = 7559811 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 6_4_0 1_0 0 01. QAP 

# granule_id = 7559813 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 7_1_0 1_0 0 01. QAP 

# granule_id = 7559815 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 7_2_0 1_0 0 01. QAP 

# granule_id = 7559817 

OUTPUT_FILE=GLA06_532_2107_002_0097_3_01_0001 .QAP 

# granule_id = 7559819 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 7_4_0 1_0 0 01. QAP 

# granule_id = 7559821 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 8_1_0 1_0 0 01. QAP 

# granule_id = 7559823 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 0 2_0 0 9 8_2_0 10 0 01. QAP 

# granule_id = 7559826 

OUTPUT_FILE=GLA06_532_2107_002_0098_3_01_0001 . QAP 

# granule_id = 7559828 

OUTPUT_FILE=GLAO 6_5 3 2_2 1 0 7_0 02_0 0 9 8_4_0 1_0 0 01. QAP 

# granule_id = 7559712 

OUTPUT_FILE=GLA12_532_2107_002_0085_0_01_0001 . QAP 

# granule_id = 7559713 

OUTPUT_FILE=GLA13_532_2107_002_0085_0_01_0001 . QAP 

# granule_id = 7559714 

OUTPUT_FILE=GLA14_532_2107_002_0085_0_01_0001 . QAP 

# granule_id = 7559715 

OUTPUT_FILE=GLAl 5_5 3 2_2 1 0 7_0 02_0 0 8 5_0_0 1_0 0 01. QAP 

OUTPUT_FILE=ANC 0 6_0 2 6_2 0060216_531244_0 l_GLAS_Al t 

WAVEFORM_PROCESS=NONE 

ELEVATION_PROCESS=E_IntrpPOD 

E L E VAT I ON_PRO CE S S=E_CalcTrop 

ELEVATION_PROCESS=E_CalcDEM 

ELEVATION_PROCESS=E_CalcSlope 

ELEVATION_PROCESS=E_CalcLoadTD 

ELEVATION_PROCESS=E_CalcOceanTD 

ELEVATION_PROCESS=E_CalcEarthTD 

ELEVATION_PROCESS=E_GetGeoid 

SURFACE TYPE=ALL 


131280752 

131282368 

131283649 

131285265 

131286551 

131288167 

131289448 

131291064 

131292350 

131293966 

131295247 

131296863 

131298150 

131299765 

131301046 

131302662 

131303949 

131224377 

131224377 

131224377 

131224377 
txt 0 0 


131282368 

131283649 

131285265 

131286551 

131288167 

131289448 

131291064 

131292350 

131293966 

131295247 

131296863 

131298150 

131299765 

131301046 

131302662 

131303949 

131305564 

131305564 

131305564 

131305564 

131305564 


532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 1 
532 1 2 
532 1 3 
532 1 4 
532 1 0 
532 1 0 
532 1 0 
532 1 0 
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Section 9 

GLAS Atm 


9.1 Function 

GLASAtm uses algorithms defined in the GLAS Atmosphere ATBD to first produce cali- 
brated backscatter cross section and then to locate all radiatively significant cloud and aerosol 
features present in the data and define their height and optical depth. This is done by first 
locating the top and bottom of the layers, differentiating between cloud and aerosol and then 
computing the extinction and optical depth of each layer. The layers are classified as either 1) 
cloud, 2) elevated aerosol, or 3) planetary boundary layer. 

In its most basic execution, GLAS Atm reads GLAS Level- 1 A GLA02 files and requisite 
ancillary files to create GLAS LIB and 2 Atmosphere product files (GLA07-1 1). However, in 
some execution scenarios, GLAS Atm can read the GLA07 file created in a previous execu- 
tion to produce GLA08-1 1 products. GLAS Atm uses the ANC07 files for constants and 
error/status messages. It uses the ANC12 DEM files to determine a preliminary elevation 
from a global Digital Elevation Model. It uses the ANC13 file to determine the geoid, ANC18 
for reference standard atmosphere measurements and ANC01 for meteorological infonnation. 
It uses ANC09 for precision attitude, and ANC04/ANC08 for precision orbit infonnation and 
ANC45 files for initializing metadata information. It uses ANC36 files generated by atm_anc 
to perform calibrations and ANC38 to perform multiple scattering corrections. ANC25 and 
ANC33 files are used for time delay and oscillator-based corrections. 

GLAS Atm should be run once after successful execution of GLAS L1A, atmanc, and 
metutil. GLAS Atm permits multi-granule input/output files, input/output time selection, 
selected execution, and reprocessing. 

9.2 Input Files 

Table 9-1 lists the inputs files to GLAS Atm. Files which are specific to GLAS Atm are doc- 
umented in this section. See the appropriate section of this document or the GLAS Data Prod- 
ucts Specifications Volumes for details regarding the non-specific files. 

9.2.1 Control File 

The control file fonnat and common elements are documented in Section 5 of this document. 
Elements specific to GLAS Atm are described here. 

The control file section delimiter for GLAS Atm is: 

=GLAS_Atm 

In order to satisfy the partial-processing/reprocessing requirement, GLAS Atm can perform 
limited processing based on execution flags within the control file. The flags and the pro- 
cesses they control are defined in Table 9-2. 

Combinations of the execution flags are allowed. For example, to perform from backscatter to 
end and no POD, the control file would have the following entries: 
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Table 9-1 GLAS Atm Inputs 


File Spec 

Type 

Source 

Short Description 

anc01*.dat 

Dynamic Ancillary 

met_util 

Meteorological subset files. 
Data sets at times before and 
after the time of the profile are 
interpolated to the time of the 
profile. If either of the ANC01 
data sets are missing, then the 
available ANC01 data set is 
used without interpolation. If no 
ANC01 data sets are available, 
then standard atmosphere data 
are used instead. 

anc04*.dat 

Dynamic Ancillary 

UTexas 

IERS Polar Motion and Earth 
Rotation Data File. 

anc07MD000.dat 

Static Ancillary 

Science Team 

Error file. 

anc07*_0001 .dat 

Static Ancillary 

Science Team 

Global constants file. 

anc07MD002.dat 

Static Ancillary 

Science Team 

Atm constants file. 

anc07MD005.dat 

Static Ancillary 

Science Team 

LI A constants file. 

anc08*.dat 

Dynamic Ancillary 

UTexas 

Precision Orbit file. 

anc09*.dat 

Dynamic Ancillary 

UTexas 

Precision Attitude file. 

anc12MD000.dat 

Static Ancillary 

Science Team 

DEM file. 

anc12*_0001 .dat 

Static Ancillary 

Science Team 

DEM mask file. 

anc13*.dat 

Static Ancillary 

Science Team 

Geoid file. 

anc18*.dat 

Static Ancillary 

Science Team 

Standard atmosphere file. 

anc24*.dat 

Dynamic Ancillary 

UTexas 

Rotation Matrix file. 

anc25*.dat 

Dynamic Ancillary 

Science Team 

GPS/UTC conversion file. 

anc30*.dat 

Static Ancillary 

Science Team 

Global aerosol categorization 
map file. 

anc27*_0000.dat 

Static Ancillary 

Science Team 

Coarse regional mask file. 

anc27*_0001.dat 

Static Ancillary 

Science Team 

Fine regional mask file. 

anc31*.dat 

Static Ancillary 

Science Team 

Aerosol tropospheric classifica- 
tion map file. 

anc33*.dat 

Dynamic Ancillary 

Science Team 

UTC time conversion file. 

anc35*.dat 

Static Ancillary 

Science Team 

Ozone file. 

anc36*.dat 

Dynamic Ancillary 

atm_anc 

Atmosphere Calibration file. 

anc38*.dat 

Static Ancillary 

Science Team 

Multiple-scattering table file. 
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Table 9-1 GLASAtm Inputs (Continued) 


File Spec 

Type 

Source 

Short Description 

anc41*.dat 

Dynamic Ancillary 

Science Team 

JPL Planetary Ephemeris 

anc45*_0002.dat 

Static Ancillary 

Science Team 

GLA02 metadata input file. 

anc45*_0007.dat 

Static Ancillary 

Science Team 

GLA07 metadata input file. 

anc45*_0008.dat 

Static Ancillary 

Science Team 

GLA08 metadata input file. 

anc45*_0009.dat 

Static Ancillary 

Science Team 

GLA09 metadata input file. 

anc45*_0010.dat 

Static Ancillary 

Science Team 

GLA10 metadata input file. 

anc45*_0011 .dat 

Static Ancillary 

Science Team 

GLA11 metadata input file. 

Control File 

Control 

ISIPS Operations 

Control file. 

gla02*_.dat 

Level-IA Product 

GLAS_L1 A 

LI A Atmosphere product file. 


Table 9-2 GLAS Atm Control Flags 


Flag 

Significance 

ATMOSPHERE_PROCESS=None 

Indicates that GLAS_Atm should perform no pro- 
cessing. 

ATMOSPHERE_PROCESS=A_bs_to_end 

Indicates that GLAS_Atm should perform all pro- 
cessing from backscatter-to-end. 

ATMOSPHERE_PROCESS=A_bs_only 

Indicates that GLAS_Atm should perform back- 
scatter-only processing. 

ATMOSPHERE_PROCESS=A_cld_to_end 

Indicates that GLAS_Atm should perform pro- 
cessing from cloud-to-end. 

ATMOSPHERE_PROCESS=A_no_pod 

Indicates that GLAS_Atm should not perform 
precision orbit determination. 

ATMOSPHERE_PROCESS=ALL 

Indicates that GLAS_Atm should perform all pro- 
cessing from backscatter-to-end, including preci- 
sion orbit determination. 


ATMOS PHERE_PROCESS=A_bs_to_end 
ATMOS PHERE_PROCESS=A_no_pod 

A control file option is available to designate that location infonnation be taken from the input 
data rather than the ANC04/08/09 geolocation file. This is useful for quick-look processing 
when the geolocation files are not yet available. 

To indicate that pass-thru processing should be used, add the following line to the control file: 
POS I T I ON= PAS S_THRU 

If this line is not included in the control file, geolocation processing will occur by default. 


March 2013 


Page 9-3 


Version 7.0 








The GLAS Science Algorithm Software (GSAS) User’s Guide GLAS_Atm 


9.3 Output Files 

Table 9-3 lists the outputs created by GLASAtm. See the appropriate section of this docu- 
ment or the GLAS Data Products Specifications Volumes for details regarding the output files 

Granule boundaries are designated by specifying start and stop times on the OUTPUT FILE 
control file entries. 


Table 9-3 GLAS Atm Outputs 


File Spec 

Type 

Destination 

Short Description 

gla07*.dat 

LIB Atm Product 

Archive 

LIB Global Backscatter product 
file. Contains full 532 nm and 
1064 nm calibrated attenuated 
backscatter profiles at 5 times 
per second, and from 10 to -1 
km, at 40 times per second. 
Also included will be calibration 
coefficient values and molecular 
backscatter profiles at once per 
second. 

gla08*.dat 

L2 Atm Product 

Archive 

L2 Planetary Boundary Layer 
and Elevated Aerosol Layer 
Height product file. Contains 
elevated aerosol layer height 
data consisting of top and bot- 
tom heights for up to 5 aerosol 
layers below 20 km at once per 
4 seconds, and top and bottom 
heights for up to 3 aerosol lay- 
ers above 20 km at once per 20 
seconds. The boundary layer 
height is provided at once per 4 
second and 5 times per second 
resolution. 

gla09*.dat 

L2 Atm Product 

Archive 

L2 Cloud Layer Height product 
file. Contains top and bottom 
heights for up to 1 0 layers below 
20 km at once per 4 seconds, 
once per second, 5 times per 
second, and 40 times per sec- 
ond (below 4 km only). Ground 
heights will also be provided at 
each resolution. 

gla10*.dat 

L2 Atm Product 

Archive 

L2 Aerosol Vertical Structure 
product file. Contains cloud and 
aerosol backscatter and extinc- 
tion cross section profiles. 
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Table 9-3 GLASAtm Outputs (Continued) 


File Spec 

Type 

Destination 

Short Description 

glair.dat 

L2 AtmProduct 

Archive 

L2 Thin Cloud/Aerosol product 
file. Contains optical depths for 
clouds for up to 10 layers, the 
planetary boundary layer, and 
aerosols for up to 8 layers. Cloud 
optical depth is at once per sec- 
ond and aerosol optical depth is 
at once per 4 second resolution. 

gla07*.qap 

L2 Atm Quality 

QA 

LIB Global Backscatter quality 
file. 

gla08*.qap 

L2 Atm Quality 

QA 

L2 Planetary Boundary Layer 
and Elevated Aerosol Layer 
Height quality file. 

gla09*.qap 

L2 Atm Quality 

QA 

L2 Cloud Layer Height quality 
file. 

gla10*.qap 

L2 Atm Quality 

QA 

L2 Aerosol Vertical Structure 
quality file. 

gla11*.qap 

L2 Atm Quality 

QA 

L2 Thin Cloud/Aerosol quality 
file. 

anc06*.txt 

Dynamic Ancillary 

ISIPS Operations 

Standard metadata/processing 
log file. 


Of importance is the relationship between the execution flags and the output products. If a 
particular execution flag is present in the control file, then the corresponding output file type 
must be present as well. Table 9-4 shows the relationship between output products and execu- 
tion flags. These relationships will be more fully defined in the next section. 


Table 9-4 GLAS Atm Execution Flags and Output Products 


Execution Flag 

Required Output Product 

ATMOSPHERE_PROCESS=A_bs_to_end 

gla07*.dat, qap07*.dat, gla08*.dat, qap08*.dat, 
gla09*.dat, qap09*dat, gla10*.dat, qap10*.dat, 
glair.datqapir.dat 

ATMOSPHERE_PROCESS=A_bs_only 

gla07*.dat, qap07*.dat, 

ATMOSPHERE_PROCESS=A_cld_to_end 

gla08*.dat, qap08*.dat, gla09*.dat, qap09*dat, 
glaKT.dat, qapKT.dat, glair.dat qapir.dat 


9.4 Processing and Reprocessing Scenarios 

GLAS Atm supports full and partial processing scenarios. Control file entries are shown for 
each supported scenario defining the requisite execution flags as well as input and output files. 
Only those control file entries unique to the particular processing scenario are show for brev- 
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ity. Additionally, even though multiple files of the same time may be needed, a single instance 
is shown. 

Time-selected processing may also be shown by specifying specific start and stop times on the 
INPUTFILE and OUTPUTFILE control file entries. 

9.4.1 Standard Processing 

This scenario is used for normal Atmosphere processing, creating GLA07, GLA08, GLA09, 
GLA10 and GLA11 data from GLA02 and the requisite ANC files. All files listed in Table 9- 
1 and Table 9-3 are required. The following execution flag is required: 

ATMOS PHERE_PROCESS=A_bs_to_end 

9.4.2 Predict Orbit Processing 

This scenario is used to quickly process Atmosphere data when only predicted orbit (ANC20) 
is available. The input files listed in Table 9-5 are required. 


Table 9-5 GLAS Atm Predict Inputs 


File Spec 

Type 

Source 

Short Description 

anc07MD000.dat 

Static Ancillary 

Science Team 

Error file. 

anc07*_0001 .dat 

Static Ancillary 

Science Team 

Global constants file. 

anc07MD002.dat 

Static Ancillary 

Science Team 

Atm constants file. 

anc07*_0005.dat 

Static Ancillary 

Science Team 

LI A constants file. 

anc12MD000.dat 

Static Ancillary 

Science Team 

DEM file. 

anc12MD001.dat 

Static Ancillary 

Science Team 

DEM mask file. 

anc13*.dat 

Static Ancillary 

Science Team 

Geoid file. 

anc18*.dat 

Static Ancillary 

Science Team 

Standard atmosphere file. 

anc20*.dat 

Dynamic Ancillary 

UTexas 

Predict Orbit file. 

anc24*.dat 

Dynamic Ancillary 

UTexas 

Rotation Matrix file. 

anc25*.dat 

Dynamic Ancillary 

Science Team 

GPS/UTC conversion file. 

anc27MD000.dat 

Static Ancillary 

Science Team 

Coarse regional mask file. 

anc27MD001.dat 

Static Ancillary 

Science Team 

Fine regional mask file. 

anc30*.dat 

Static Ancillary 

Science Team 

Global aerosol categorization 
map file. 

anc31*.dat 

Static Ancillary 

Science Team 

Aerosol tropospheric classifica- 
tion map file. 

anc33*.dat 

Dynamic Ancillary 

Science Team 

UTC time conversion file. 

anc35*.dat 

Static Ancillary 

Science Team 

Ozone file. 

anc38*.dat 

Static Ancillary 

Science Team 

Multiple-scattering table file. 
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Table 9-5 GLASAtm Predict Inputs (Continued) 


File Spec 

Type 

Source 

Short Description 

anc41*.dat 

Dynamic Ancillary 

Science Team 

JPL Planetary Ephemeris 

anc45*_0002.dat 

Static Ancillary 

Science Team 

GLA02 metadata input file. 

anc45*_0007.dat 

Static Ancillary 

Science Team 

GLA07 metadata input file. 

anc45*_0008.dat 

Static Ancillary 

Science Team 

GLA08 metadata input file. 

anc45*_0009.dat 

Static Ancillary 

Science Team 

GLA09 metadata input file. 

anc45*_0010.dat 

Static Ancillary 

Science Team 

GLA10 metadata input file. 

anc45*_0011 .dat 

Static Ancillary 

Science Team 

GLA11 metadata input file. 

Control File 

Control 

ISIPS Operations 

Control file. 

gla02*_.dat 

Level-IA Product 

GLAS_L1 A 

LI A Atmosphere product file. 


9.4.3 Partial Processing: Backscatter 

This scenario is used for backscatter-only Atmosphere processing, creating GLA07 data from 
GLA02 and the requisite ANC files. All files listed in Table 9-1 and Table 9-3 are required, 
with the following exceptions: 

• GLA08- 1 1 output files are not required. 

• QAP08- 1 1 output files are not required. 

The following execution flag is required: 

ATMOS PHERE_PROCESS=A_bs_only 

9.4.4 Partial Processing/Re-Processing: Cloud-to-End 

This scenario is used for cloud-to-end Atmosphere -related data, creating GLA08-1 1 data from 
selected GLA07 products (created during a previous execution of GLAS Atm) and the requi- 
site ANC files. All files listed in Table 9-1 and Table 9-3 are required, with the following 
exception: 

• GLA07 is required as an input file, but not an output file. 

The following execution flag is required: 

ATMOS PHERE_PROCE S S = A_c 1 d_t o_end 

9.5 Startup and Termination 

This is an overview of the steps necessary to run GLAS_Atm. 

9.5.1 Setup a Runtime Directory 

The suggested method of running GLAS Atm is to create a temporary directory and link all 
necessary files into it The SDMS will create a temporary directory and link all necessary files 
into it. For example, to setup a GLAS Atm run, one would perfonn the following steps (Des- 
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ignate TEMPDIR as the temporary directory and DATADIR as the location in which input 
data for this job has been staged): 

mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/ GLASAtm . 

In -s $GLAS_HOME/lib/* . 

In -s $GLAS_HOME/data/anc*.dat . 

In -s $D ATA_DIR/* . dat . 

9.5.2 Create a Control File 

GLAS Atm is designed to take the name of a control file as a command-line argument. The 
suggested method of creating a control file is by copying a template from the 
$GLAS_HOME/data directory and modifying it with desired input/output filenames and data 
processing options. 

cp $GLAS_HOME/data/cf_glas_atm.ctl ./ control file name 
vi ./control Jilejiame 

9.5.3 Run the PGE 

Error and status messages will be displayed on screen (stdout) and recorded in the ANC06 
file. 


./GLAS_Atm control Jilejiame 

9.5.4 Run-Time Statistics 

GLAS Atm processes 25 hours of GLAS data in approximately four hours. This may vary 
due to hardware load and data dependencies. 

9.5.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. The log/ 
metadata file ( ANC06*) must be examined to determine runtime success. Additionally, the 
process will return a result code to the operating system which may be used to programatically 
detennine success or failure (0=success, 3=fatal error). 

9.6 Error and Warning Messages 

All GSAS error and warning messages are numerically listed in Appendix D. 

9.7 Recovery Steps 

If GLAS Atm terminates with an error: 

1) Review error and status messages in the ANC06 file or on stdout to detennine 
source or location of problem. 

2) Conect the problem 

3) Remove previous output files 
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4) Re-run the software 

In case of a problematic error, which cannot be easily diagnosed, debug versions of 
GLASAtm will be available for test use. This is, however, more of a developer procedure 
than a user procedure. Software users should contact the GSAS Development Team for more 
instructions 

9.8 Sample GLAS_Atm Control File 

=GLAS_Atm 

PGE_VERSION=ACC 

PASSID=6407 21070020365 132847317 132853116 -167.03262 3387 
PASSID=6408 21070020366 132853116 132858915 168.77177 3388 
PASSID=6409 21070020367 132858915 132864714 144.57681 3389 
PASSID=6410 21070020368 132864714 132870513 120.38229 3390 
PASSID=6411 21070020369 132870513 132876312 96.18598 3391 
PASSID=6412 21070020370 132876312 132882112 71.9897 3392 
PASSID=6413 21070020371 132882112 132887911 47.79437 3393 
PASSID=6414 21070020372 132887911 132893710 23.599838 3394 
PASSID=6415 21070020373 132893710 132899509 -0.5939026 3395 
PASSID=6416 21070020374 132899509 132905308 -24.787994 3396 
PASSID=6417 21070020375 132905308 132911107 -48.983124 3397 
PASSID=6418 21070020376 132911107 132916906 -73.177734 3398 
PASSID=6419 21070020377 132916906 132922705 -97.371826 3399 
PASSID=642 0 21070020378 132922705 132928504 -121.566666 3400 
PASSID=6421 21070020379 132928504 132934303 -145.76212 3401 

INPUT_FILE=GLA02_02 6_2 1 0 7_0 02_03 6 5_0_01_0 0 01. DAT 132848124 132859722 26 1 0 

INPUT_FILE=GLA02_02 6_2 1 0 7_0 02_03 6 7_0_01_0 0 01. DAT 132859722 132871321 26 1 0 

INPUT_FILE=GLA02_02 6_2 1 0 7_0 02_03 6 9_0_01_0 0 01. DAT 132871321 132882919 26 1 0 
INPUT_FILE=GLA02_02 6_2 1 0 7_0 02_03 71_0_01_0 0 01. DAT 132882919 132894517 26 1 0 
INPUT_FILE=GLA02_02 6_2 1 0 7_0 02_03 73_0_01_0 0 01. DAT 132894517 132906115 26 1 0 
INPUT_FILE=GLA02_02 6_2 1 0 7_0 02_03 7 5_0_01_0 0 01. DAT 132906115 132917713 26 1 0 

INPUT_FILE=GLA02_0 2 6_2 1 0 7_0 02_0 3 7 7_0_0 1_0 0 01. DAT 132917713 132929312 26 1 0 

INPUT_FILE=ANC01_0 05_2 0 04 03 17_18 0 0 0 0_01_0 0 0 0. DAT 132818400 132861600 
INPUT_FILE=ANC0 1_0 05_2 0 04 03 17_18 0 0 0 0_01_0 0 01. DAT 132818400 132861600 
INPUT_FILE=ANC0 1_0 05_2 0 04 03 17_18 0 0 0 0_01_0 0 02. DAT 132818400 132861600 
INPUT_FILE=ANC0 1_0 05_2 0 04 03 17_18 0 0 0 0_01_0 0 03. DAT 132818400 132861600 
INPUT_FILE=ANC0 1_0 05_2 0 04 03 17_18 0 0 0 0_01_0 0 04. DAT 132818400 132861600 
INPUT_FILE=ANC01_0 05_2 0 04 03 17_18 0 0 0 0_01_0 0 05. DAT 132818400 132861600 
INPUT_FILE=ANC0 1_0 05_2 0 04 03 17_18 0 0 0 0_01_0 0 0 6. DAT 132818400 132861600 
INPUT_FILE=ANC01_0 05_2 0 04 03 17_18 0 0 0 0_01_0 0 0 7. DAT 132818400 132861600 
INPUT_FILE=ANC01_0 05_2 0 04 03 17_18 0 0 0 0_01_0 0 0 8. DAT 132818400 132861600 
INPUT_FILE=ANC01_0 05_2 0 04 03 17_18 0 0 0 0_01_0 0 0 9. DAT 132818400 132861600 
INPUT_FILE=ANC0 1_0 05_2 0 04 03 17_18 0 0 0 0_01_0 010 . DAT 132818400 132861600 
INPUT_FILE=ANC01_0 05_2 0 04 03 18_0 0 0 0 0 0_01_0 0 0 0. DAT 132840000 132883200 
INPUT_FILE=ANC0 1_0 05_2 0 04 03 18_0 0 0 0 0 0_01_0 0 01. DAT 132840000 132883200 
INPUT_FILE=ANC0 1_0 05_2 0 04 03 18_0 0 0 0 0 0_01_0 0 02. DAT 132840000 132883200 
INPUT_FILE=ANC0 1_0 05_2 0 04 03 18_0 0 0 0 0 0_01_0 0 03. DAT 132840000 132883200 
INPUT_FILE=ANC01_0 05_2 0 04 03 18_0 0 0 0 0 0_01_0 0 04. DAT 132840000 132883200 
INPUT_FILE=ANC01_0 05_2 0 04 03 18_0 0 0 0 0 0_01_0 0 05. DAT 132840000 132883200 
INPUT_FILE=ANC0 1_0 05_2 0 04 03 18_0 0 0 0 0 0_01_0 0 0 6. DAT 132840000 132883200 
INPUT_FILE=ANC01_0 05_2 0 04 03 18_0 0 0 0 0 0_01_0 0 0 7. DAT 132840000 132883200 
INPUT_FILE=ANC01_0 05_2 0 04 03 18_0 0 0 0 0 0_01_0 0 0 8. DAT 132840000 132883200 
INPUT_FILE=ANC01_0 05_2 0 04 03 18_0 0 0 0 0 0_01_0 0 0 9. DAT 132840000 132883200 
INPUT_FILE=ANC01_0 05_2 0 04 03 18_0 0 0 0 0 0_01_0 010 . DAT 132840000 132883200 
INPUT_FILE=ANC01_0 05_2 0 04 03 18_0 6 0 0 0 0_01_0 0 0 0. DAT 132861600 132904800 
INPUT FILE=ANC01 005 20040318 060000 01 0001.DAT 132861600 132904800 
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INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC01_005_20 
INPUT_FILE=ANC04_006_20 
INPUT_FILE=ANC04_006_20 
INPUT_FILE=anc07_026_01 
INPUT_FILE=anc07_026_01 
INPUT_FILE=anc07_026_01 
INPUT_FILE=anc07_026_01 
INPUT_FILE=anc07_026_01 
INPUT_FILE=anc07_026_01 
INPUT_FILE=anc07_026_01 
INPUT_FILE=ANC08_008_20 
INPUT_FILE=ANC08_008_20 
INPUT_FILE=ANC0 9_94 0_2 0 
INPUT_FILE=ANC09_940_20 
INPUT_FILE=ancl2_004_01 
INPUT_FILE=ancl2_004_01 
INPUT_FILE=ancl3_005_01 
INPUT FILE=ancl8 001 01 


04 03 18_0 6 0 0 0 0_01_0 0 02 . 
04 03 18_0 6 0 0 0 0_01_0 0 03 . 
04 03 18_0 6 0 0 0 0_01_0 0 04 . 
04 03 18_0 6 0 0 0 0_01_0 0 05 . 
04 03 18_0 6 0 0 0 0_01_0 0 06 . 
04 03 18_0 6 0 0 0 0_01_0 0 0 7. 
04 03 18_0 6 0 0 0 0_01_0 0 0 8 . 
04 03 18_0 6 0 0 0 0_01_0 0 0 9. 
04 03 18_0 6 0 0 0 0_01_0 010 . 
04 03 18_12 00 0 0_01_0 0 0 0. 
04 03 18_12 00 0 0_01_0 0 01. 
04 03 18_12 0 0 0 0_01_0 0 02 . 
04 03 18_12 0 0 0 0_01_0 0 03 . 
04 03 18_12 00 0 0_01_0 0 04 . 
04 03 18_12 0 0 0 0_01_0 0 05 . 
04 03 18_12 0 0 0 0_01_0 0 06 . 
04 03 18_12 0 0 0 0_01_0 0 0 7. 
04 03 18_12 00 0 0_01_0 0 0 8 . 
04 03 18_12 0 0 0 0_01_0 0 0 9. 
04 03 18_12 0 0 0 0_01_0 010 . 
04 03 18_18 0 0 0 0_01_0 0 0 0. 
04 03 18_18 0 0 0 0_01_0 0 01. 
04 03 18_18 0 0 0 0_01_0 0 02 . 
04 03 18_18 0 0 0 0_01_0 0 03 . 
04 03 18_18 0 0 0 0_01_0 0 04 . 
04 03 18_18 0 0 0 0_01_0 0 05 . 
04 03 18_18 0 0 0 0_01_0 0 06 . 
04 03 18_18 0 0 0 0_01_0 0 0 7. 
04 03 18_18 0 0 0 0_01_0 0 0 8 . 
04 03 18_18 0 0 0 0_01_0 0 0 9. 
04 03 18_18 0 0 0 0_01_0 010 . 
040319_000000_01_0000 . 
04 03 19_0 0 0 0 0 0_01_0 0 01. 
04 03 19_0 0 0 0 0 0_01_0 0 02 . 
04 031 9_0 0 0 0 0 0_0 1_0 0 03 . 
04 03 19_0 0 0 0 0 0_01_0 0 04 . 
04 03 19_0 0 0 0 0 0_01_0 0 05 . 
04 03 19_0 0 0 0 0 0_01_0 0 06 . 
04 03 19_0 0 0 0 0 0_01_0 0 0 7. 
04 031 9_0 0 0 0 0 0_0 1_0 0 0 8 . 
04 03 19_0 0 0 0 0 0_01_0 0 0 9. 
04 03 19_0 0 0 0 0 0_01_0 010 . 
04 03 17_23 594 7_01_0 0 01. 
04 03 18_23 594 7_01_0 0 01. 
_0000.dat 0 0 
_0001.dat 0 0 
_0002.dat 0 0 
_0003.dat 0 0 
_0004.dat 0 0 
_0005.dat 0 0 
_0006.dat 0 0 
04 03 17_23 594 7_01_0 0 01. 
04 03 18_23 594 7_01_0 0 01. 
04 03 17_23 594 7_01_0 0 01. 
04 03 18_23 594 7_01_0 0 01. 
_0000.dat 0 0 
_0001.dat 0 0 
_0000.dat 0 0 
0000 . dat 0 0 


DAT 132861600 132904800 
DAT 132861600 132904800 
DAT 132861600 132904800 
DAT 132861600 132904800 
DAT 132861600 132904800 
DAT 132861600 132904800 
DAT 132861600 132904800 
DAT 132861600 132904800 
DAT 132861600 132904800 
DAT 132883200 132926400 
DAT 132883200 132926400 
DAT 132883200 132926400 
DAT 132883200 132926400 
DAT 132883200 132926400 
DAT 132883200 132926400 
DAT 132883200 132926400 
DAT 132883200 132926400 
DAT 132883200 132926400 
DAT 132883200 132926400 
DAT 132883200 132926400 
DAT 132904800 132948000 
DAT 132904800 132948000 
DAT 132904800 132948000 
DAT 132904800 132948000 
DAT 132904800 132948000 
DAT 132904800 132948000 
DAT 132904800 132948000 
DAT 132904800 132948000 
DAT 132904800 132948000 
DAT 132904800 132948000 
DAT 132904800 132948000 
DAT 132926400 132969600 
DAT 132926400 132969600 
DAT 132926400 132969600 
DAT 132926400 132969600 
DAT 132926400 132969600 
DAT 132926400 132969600 
DAT 132926400 132969600 
DAT 132926400 132969600 
DAT 132926400 132969600 
DAT 132926400 132969600 
DAT 132926400 132969600 
DAT 132839987 132926387 
DAT 132926387 133012787 


DAT 132839987 132926387 
DAT 132926387 133012787 
DAT 132839987 132926387 
DAT 132926387 133012787 
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INPUT_FILE=anc2 5_0 0 1_2 0 05123 1_0 0 0 0 0 0_0 1_0 0 0 0. dat 0 0 
INPUT_FILE=anc27_001_01_0000 . dat 0 0 
INPUT_FILE=anc27_001_01_0001 . dat 0 0 
INPUT_FILE=anc30_001_01_0000 .dat 0 0 

INPUT_FILE=anc31_004_20031120_000000_01_0000 .dat 122558400 284040000 
INPUT_FILE=ANC33_001_20051020_000000_01_0000 . DAT 0 0 
INPUT_FILE=anc35_001_01_0000 . dat 0 0 

INPUT_FILE=ANC36_026_21_07002_0365_0_01_0001 .DAT 132848124 132859722 

INPUT_FILE=ANC36_026_21_07002_0367_0_01_0001 .DAT 132859722 132871321 

INPUT_FILE=ANC36_026_21_07002_0369_0_01_0001 .DAT 132871321 132882919 

INPUT_FILE=ANC36_026_21_07002_0371_0_01_0001 .DAT 132882919 132894517 

INPUT_FILE=ANC36_026_21_07002_0373_0_01_0001 .DAT 132894517 132906115 

INPUT_FILE=ANC36_026_21_07002_0375_0_01_0001 .DAT 132906115 132917713 

INPUT_FILE=ANC36_026_21_07002_0377_0_01_0001 .DAT 132917713 132929312 

INPUT_FILE=anc38_001_01_0000 .dat 0 0 

INPUT_FILE=anc41_009_01_0000 .dat 0 0 

INPUT_FILE=anc45_026_01_0001 .dat 0 0 

INPUT_FILE=anc45_026_01_0002 .dat 0 0 

INPUT_FILE=anc45_026_01_0003 .dat 0 0 

INPUT_FILE=anc45_026_01_0004 .dat 0 0 

INPUT_FILE=anc45_026_01__0005 . dat 0 0 

INPUT_FILE=anc45_026_01_0006 .dat 0 0 

INPUT_FILE=anc45_026_01_0007 . dat 0 0 

INPUT_FILE=anc45_026_01_0008 .dat 0 0 

INPUT_FILE=anc45_026_01__0009 . dat 0 0 

INPUT_FILE=anc45_026_01_0010 .dat 0 0 

INPUT_FILE=anc45_026_01_0011 .dat 0 0 

INPUT_FILE=anc45_026_01_0012 . dat 0 0 

INPUT_FILE=anc45_026_01_0013 .dat 0 0 

INPUT_FILE=anc45_026_01_0014 .dat 0 0 

INPUT_FILE=anc45_026_01_0015 .dat 0 0 

OUTPUT_FILE=GLAO 7_532_2 107_0 02_03 65_0_0 10 001. DAT 132848124 132859722 532 1 0 

OUTPUT_FILE=GLAO 7_532_2 107_0 02_03 67_0_0 10 001. DAT 132859722 132871321 532 1 0 

OUTPUT_FILE=GLAO 7_532_2 107_0 02_03 6 9_0_0 10 001. DAT 132871321 132882919 532 1 0 
OUTPUT_FILE=GLAO 7_532_2 107_0 02_03 7 1_0_0 10 001. DAT 132882919 132894517 532 1 0 
OUTPUT_FILE=GLAO 7_532_2 107_0 02_03 73_0_0 10 0 01. DAT 132894517 132906115 532 1 0 
OUTPUT_FILE=GLAO 7_532_2 107_0 02_03 7 5_0_0 10 0 01. DAT 132906115 132917713 532 1 0 

OUTPUT_FILE=GLAO 7_532_2 107_0 02_03 77_0_0 1_0 001. DAT 132917713 132929312 532 1 0 

OUTPUT_FILE=GLAO 7_5 3 2_2 1 0 7_0 02_0 3 6 5_0_0 10 0 01. QAP 132848124 132859722 532 1 0 

OUTPUT_FILE=GLAO 7_5 3 2_2 1 0 7_0 02_0 3 6 7_0_0 10 0 01. QAP 132859722 132871321 532 1 0 

OUTPUT_FILE=GLAO 7_5 3 2_2 1 0 7_0 02_0 3 6 9_0_0 10 0 01. QAP 132871321 132882919 532 1 0 
OUTPUT_FILE=GLAO 7_5 3 2_2 1 0 7_0 02_0 3 7 1_0_0 10 0 01. QAP 132882919 132894517 532 1 0 
OUTPUT_FILE=GLAO 7_5 3 2_2 1 0 7_0 02_0 3 7 3_0_0 10 0 01. QAP 132894517 132906115 532 1 0 
OUTPUT_FILE=GLA0 7_532_2107_0 02_03 75_0_01_0 0 01 . QAP 132906115 132917713 532 1 0 

OUTPUT_FI LE=GLA0 7_5 3 2_2 107_002_037 7_0_0 1_0 0 01. QAP 132917713 132929312 532 1 0 

OUTPUT_FILE=GLAO 8_532_2 107_0 02_03 65_0_0 10 001. DAT 132848124 132929312 532 1 0 

OUTPUT_FI LE=GLA0 8_5 3 2_2 107_002_036 5_0_0 10 0 01. QAP 132848124 132929312 532 1 0 

OUTPUT_FILE=GLAO 9_532_2 107_0 02_03 65_0_0 10 001. DAT 132848124 132929312 532 1 0 

OUTPUT_FI LE=GLA0 9_5 3 2_2 107_002_036 5_0_0 10 0 01. QAP 132848124 132929312 532 1 0 

0UTPUT_FILE=GLA1 0_5 3 2_2 1 0 7_0 02_0 3 6 5_0_0 1_0 0 01. DAT 132848124 132929312 532 1 0 

0UTPUT_FILE=GLA1 0_5 3 2_2 1 0 7_0 02_0 3 6 5_0_0 1_0 0 01. QAP 132848124 132929312 532 1 0 

0UTPUT_FILE=GLA11_532_2 107_0 02_03 65_0_0 1_0 001. DAT 132848124 132929312 532 1 0 

0UTPUT_FILE=GLA1 1_5 3 2_2 1 0 7_0 02_0 3 6 5_0_0 1_0 0 01. QAP 132848124 132929312 532 1 0 

OUTPUT_FILE=ANCO 6_02 6_2 0 06 0216_53 12 87_0 l_GLAS_Atm . txt 0 0 
ATMOSPHERE PROCESS=ALL 
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Section 10 

GLAS Reader 


10.1 Function 

GLASReader reads nearly all GLAS product and ancillary files and prints the data contained 
within those files in human-readable format. 

GLAS Reader differs from other PGEs in that it has a rudimentary interface which will let the 
user specify input files from the command line. As with control file specifications, start and 
stop times are required along with the filename. The interface is invoked when running 
GLAS Reader without a control file argument. 

GLAS Reader performs no processing, but pennits specification of what type of data should 
be written to the text file. GLAS Reader also supports input/output time selection. 

Note: GLAS Reader is not intended for production use. 

10.2 Input Files 

Table 10-1 lists the potential inputs files to GLAS Reader. All or some of these files may be 
specified. Note, however, than GLA00 APID files may not be specified without also specify- 
ing a corresponding ANC29 file. See the appropriate section of this document or the GLAS 
Data Products Specifications Volumes for details regarding the non-specific files. 


Table 10-1 GLAS Reader Inputs 


File Spec 

Type 

Source 

Short Description 

ancOI* 7777.dat 

Dynamic Ancillary 

met_util 

Subsetted meteorological files. 
There is a separate ANC01 file 
per data type. All of the ANC01 
files must be specified. 

anc07*_0000.dat 

Static Ancillary 

Science Team 

GLAS error file. 

anc07*_0001 dat 

Static Ancillary 

Science Team 

GLAS global constants file. 

anc07*_0002.dat 

Static Ancillary 

Science Team 

GLAS waveform constants file. 

anc07*_0003.dat 

Static Ancillary 

Science Team 

GLAS elevation constants file. 

anc07*_0004.dat 

Static Ancillary 

Science Team 

GLAS atmosphere constants 
file. 

anc07*_0005.dat 

Static Ancillary 

Science Team 

GLAS LI A constants file. 

anc08*.dat 

Dynamic Ancillary 

UTexas 

Precision orbit file. 

anc09*.dat 

Dynamic Ancillary 

UTexas 

Precision Attitude Data 

anci 2MJ001.dat 

Static Ancillary 

Science Team 

DEM mask file. 

anc13*.dat 

Static Ancillary 

Science Team 

Geoid file 
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Table 10-1 GLASReader Inputs (Continued) 


File Spec 

Type 

Source 

Short Description 

anc16*.dat 

Static Ancillary 

Science Team 

Ocean Tide file 

anc17*.dat 

Static Ancillary 

Science Team 

Load Tide file 

anc18*.dat 

Static Ancillary 

Science Team 

Standard Atmosphere file 

anc22*.dat 

Dynamic Ancillary 


Reference Orbit Ascending 
Nodes 

anc23*.dat 

Dynamic Ancillary 


NOSE rectangle coordinates 

anc25*.dat 

Dynamic Ancillary 

Science Team 

GPS/UTC conversion file. 

anc27*.dat 

Static Ancillary 

Science Team 

Regional mask files. 

anc30*.dat 

Static Ancillary 

Science Team 

Aerosol file 

anc31*.dat 

Static Ancillary 

Science Team 

Troposphere file 

anc32*.dat 

Dynamic Ancillary 

GLAS_L0proc 

Frequency board to GPS time 
correlation file. 

anc33*.dat 

Dynamic Ancillary 

Science Team 

UTC time conversion file. 

anc36*.dat 

Dynamic Ancillary 

atm_anc 

Atmosphere Calibration file. 

anc45*.dat 

Static Ancillary 

Science Team 

Metadata input files. 

anc52*.dat 

Static Ancillary 

Instrument Team 

Saturation Correction Tables 

Control File 

Control 

ISIPS Operations 

Control file. 

glaOOTdat/ 

ANC29*.dat 

Level-0 APID/ 
Dynamic Ancillary 

EDOS / 

GLAS_L0proc 

GLAS Level-0 APID files and 
the requisite ANC29 index file. 

glafdat 

GLAS Product 

GSAS 

GLAS Product files. 

gla*.qap 

GLAS QA 

GSAS 

GLAS QA files 


10.2.1 Control File 

The control file fonnat and common elements are documented in Section 5 of this document. 
Elements specific to GLAS Reader are described here. 

The control file section delimiter for GLAS Reader is: 

=GLAS_Reader 

Where appropriate, GLAS Reader can print different types of data to the output file. The type 
of data printed is based on execution flags within the control file. The flags and the data types 
they control are defined in Table 10-2. 

Combinations of the execution flags are allowed. For example, to print both algorithm and 
scale values, the control file would have the following entries: 
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Table 10-2 

GLAS Reader Control Flags 

Flag 

Significance 

READER_OPTION=PRODUCT 

Indicates that GLAS_Reader should print product- 
type data (scaled integers). 

READER_OPTION=ALGORITHM 

Indicates that GLAS_Reader should print data con- 
verted as used in science algorithms. 

READER_OPTION=SCALE 

Indicates that GLAS_Reader should print the scale 
factors. 

READER_OPTION=ALL 

Indicates that GLAS_Reader should print all of the 
data types listed above. 


READER_OPT I ON= ALGOR I THM 
READERJOPT I ON= S CALE 

10.3 Output Files 

GLASReader requires no OUTPUTFILE specifications in the control file. GLASReader 
will create an output file for each type of input file requested. GLAS Reader will strip the 
‘.dat’ from the specified input filename and replace it with a ‘.txt’ extension. Time selection 
for the output files is based on the time specified with the input files. 

A corresponding ANC29 file is required to process GLA00 APID files. When processing 
GLA00 APID files, GLAS Reader writes all output to the ANC29 text file, instead of to indi- 
vidual APID files. The benefit of this is that the output is created in time-aligned fashion. Also 
note that specific APID files may be processed even though the ANC29 file was created with 
a superset of the selected APIDs. 

10.4 Startup and Termination 

This is an overview of the steps necessary to run GLAS_Reader. 

10.4.1 Setup a Runtime Directory 

The suggested method of running GLAS Reader is to create a temporary directory and link 
all necessary files into it. For example, to setup a GLAS Reader run, one would perform the 
following steps (Designate TEMP DIR as the temporary directory and DATA DIR as the 
location in which input data for this job has been staged): 

mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/GLAS_Reader. 

In -s $GLAS_HOME/lib/* . 

In -s $GLAS_HOME/data/anc*.dat. 

In -s $DATA_DIR/*.dat. 
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10.4.2 Create a Control File 

GLASReader is designed to take the name of a control file as a command-line argument. The 
suggested method of creating a control file is by copying a template from the 
$GLAS_HOME/data directory and modifying it with desired input/output filenames and data 
processing options. 

cp $G LAS H O M E/data/ c f glas reader. c f .! control Jilejiame 
vi ./control Jilejiame 

10.4.3 Run the PGE 

Error and status messages will be displayed on screen (stdout) and recorded in the ANC06 
file. 


./GLAS_Reader control Jilejiame 

10.4.4 Run-Time Statistics 

Since GLAS APID will not be used in the production environment, no runtime statistics have 
been recorded. 

10.4.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. The log/ 
metadata file (ANC06*) must be examined to determine runtime success. Additionally, the 
process will return a result code to the operating system which may be used to programatically 
detennine success or failure (0=success, 3=fatal error). 

10.5 Error and Warning Messages 

All GSAS error and warning messages are numerically listed in Appendix D. 

10.6 Recovery Steps 

If GLAS Reader tenninates with an error: 

1) Review error and status messages in the ANC06 file or on stdout to detennine 
source or location of problem. 

2) Conect the problem 

3) Remove previous output files 

4) Re-run the software 

In case of a problematic error, which cannot be easily diagnosed, debug versions of 
GLAS Reader will be available for test use. This is, however, more of a developer procedure 
than a user procedure. Software users should contact the GSAS Development Team for more 
instructions 
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10.7 Sample GLAS_Reader Control File 

This control file reads and writes 100 seconds of ANC29, ANC32, and GLA00 APIDs 17 and 
19. It writes only Algorithm values to the output files. ANC32 data are written in 
anc32_002_20000101_000000_01_0000.txt. The ANC29 and GLA00 APID data are written 
to anc29_002_20000 1 0 1 000000 0 l_0000.txt. 

# 

# This is the control file for the GLAS_Reader. 

# 

# Execution Information 

# 

=GLAS_Reader 

EXEC_KEY=p3tla 

DATE_GENERATED= 0 8 August 2 0 01 
OPERATORS lee 
PGE_VERSION=2 .2 
# 

# Dynamic ANC Files 

# 

# ANC29 and ANC32 files 

# 

INPUT_FILE=anc2 9_0 02_2 0 0 0 010 1_0 0 0 0 0 0_0 1_0 0 0 0. dat 0 100 
INPUT_FILE=anc3 2_0 02_2 0 0 0 010 1_0 0 0 0 0 0_0 1_0 0 0 0. dat 0 100 
# 

# GLA00 files 

# 

INPUT_FILE=glaOO_002_20000101_000000_01_0017 . dat 0 100 
INPUT_FILE=glaOQ_002_20000101_000000_01_0019 . dat 0 100 


# 

# Execution Control 

# 

READER_OPTION=Algorithm 

# 

# End of Control File 

# 
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Section 11 

met util 


11.1 Function 

This utility, met_util, creates ANC01 subset files (i.e. temperature, relative humidity, etc.) 
from a meteorological (ANC40) file. The ANC40 file is a standard GRIB file received from 
GSFC. The subset files are used as input for several of the GSAS PGEs. metutil reads the 
ANC07 file for error definitions. 

met util uses a subset of the standard GSAS control file with several modifications. The for- 
mat of the met_util control file will be fully documented in a later subsection. met_util does 
not use an ANC06 file, has no processing control and no time selection capabilities. 

met util should be run before executing GLAS Alt or GLASAtm (which require the subset- 
ted ANC01 files) for the corresponding span of data. 

11.2 Input Files 

Table 11-1 lists the inputs files to met util. The ANC40 file is the NCEP Global Analysis, a 1- 
by-1 degree gridded data set with sampling every 6 hours. Variables included are tempera- 
ture, geopotential height, and relative humidity at standard upper atmospheric pressure levels. 
The ANC40 files are in the GRIB format, which is the WMO (World Meteorological Organi- 
zation) standard for exchanging gridded binary data. All of these files must be specified and 
named according to GSAS file naming conventions. 


Table 11-1 met_util Inputs 


File Spec 

Type 

Source 

Short Description 

anc40*.dat 

Dynamic Ancillary 

GSFC 

Standard MET file. 

anc07*_0000.dat 

Static Ancillary 

Science Team 

GLAS error file. 

anc07*_0006.dat 

Static Ancillary 

Science Team 

GLAS utility constants file. 

Control File 

Control 

ISIPS Operations 

Control file. 


11.2.1 Control File 

The met_util control file is a subset of the standard GSAS control file. The basic fonnat of this 
file is documented in Section 5 of this document, met util does not use the common elements 
used in other GSAS control files. 

The control file section delimiter for met util is: 

=met_util 

The only keywords met util uses are “INPUTFILE”, “OUTPUTFILE”, and the control file 
section delimiter. The “INPUT FILE” and “OUTPUT FILE” specifications do not have start 
time and stop times. 
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11.3 Output Files 

Table 11-2 lists the specific subset output files created by metutil. The five files are an ASCII 
header file, a height file, a temperature file, a relative humidity file, and a precipitable water 
table file. The last four files are binary with no header. 

Each record in the binary output file contains the global gridded values of the respective 
parameter at a particular pressure level. The first record is at the highest pressure level, and 
the last record is at the lowest pressure level. The ASCII header file lists the record number, 
location, date, pressure level, and parameter name (as read from the MET file). Refer to http:/ 
/wesley. wwb.noaa.gov/wgrib.html for details 

Output files must be named according to standard GSAS naming conventions. 


Table 11-2 met util Outputs 


File Spec 

Type 

Destination 

Short Description 

anc01MD000.dat 

Dynamic Ancillary 

GSAS PGEs / 
Archive 

Subsetted meteorological 
header file. 

anc0r_0001.dat 

Dynamic Ancillary 

GSAS PGEs / 
Archive 

Subsetted meteorological pre- 
cipitable water file. 

anc0r_0002.dat 

Dynamic Ancillary 

GSAS PGEs / 
Archive 

Subsetted meteorological height 
file. 

anc01MD003.dat 

Dynamic Ancillary 

GSAS PGEs / 
Archive 

Subsetted meteorological rela- 
tive humidity file. 

anc01MD004.dat 

Dynamic Ancillary 

GSAS PGEs / 
Archive 

Subsetted meteorological tem- 
perature file. 


11.4 Startup and Termination 

This is an overview of the steps necessary to run met util. Specific operational procedures for 
each of the supported scenarios are provided in the ISIPS Operational Procedures Manual. 

11.4.1 Setup a Runtime Directory 

The suggested method of running met util is to create a temporary directory and link all nec- 
essary files into it. The SDMS will create a temporary directory and link all necessary files 
into it. For example, to setup a met_util run, one would perform the following steps (Desig- 
nate TEMP DIR as the temporary directory and DATA DIR as the location in which input 
data for this job has been staged): 

mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/met_util . 

In -s $GLAS_HOME/bin/wgrib . 

In -s $GLAS_HOME/bin/SDMS_met_script . 

In -s $GLAS_HOME/lib/* . 
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In -s $ G LA S_H O M E/ clata/an c * . dat . 

In -s $DATA_DIR/*.dat . 

11.4.2 Create a Control File 

metutil is designed to take the name of a control file as a command-line argument. The sug- 
gested method of creating a control file is by copying a template from the $GLAS_HOME/ 
data directory and modifying it with desired input/output filenames and data processing 
options. 

cp $GLAS_HOME/data/cf_met_util.ctl ./control Jilejiame 
vi ./control Jilejiame 

11.4.3 Run the PGE 

Error and status messages will be displayed on the screen (stdout) and recorded in the ANC06 
file. 

./met_util control Jilejiame 

11.4.4 Run-Time Statistics 

met util subsets one file (6 hours) of meteorological data in less than a minute. This may vary 
due to hardware load and data dependencies. 

11.4.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. Standard 
output (stdout) must be examined to determine runtime success. Additionally, the process will 
return a result code to the operating system which may be used to programatically detennine 
success or failure (0=success, 3=fatal error). 

11.5 Error and Warning Messages 

Fatal errors are generated if there is a problem opening or reading a file. When an error 
occurs, an error message is printed to the standard output. It includes the error number, sever- 
ity, process name where the error occurred, a short description, and the file name if the error 


occurred while accessing a file. 

Errors possible from met util with the severity and frequency include: 

ERROR=-10002 No control file specified 3 1 

ERROR= - 1 0 0 1 4 Unrecognized line in control file 3 1 

ERROR=-10015 Unknown value in keyword/value pair 3 1 

ERROR= - 1 0 0 1 7 I/O Error Reading Control File 3 1 

ERROR=-10046 Error returned from script 3 1 

ERROR=- 10047 File naming conventions do not match 3 1 


The error severity and frequency may be modified as described in the error section. 
Explanations of these errors follow: 
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Table 11-3 Error Resolution 


Error Type 

Ensure that: 

No control file specified 

- control file name is typed correctly on command line 

Reading File 

- file is available 

- file is not corrupt - regenerate if necessary 

Unrecognized line in control 
file 

- keywords have not been changed in control file 

- extraneous lines have not been added to control file 

Unknown value in keyword/ 
value pair 

- input and output file names in control file conform to their correct 
naming conventions 

File naming conventions do 
not match 

- input and output file names in control file conform to their correct 
naming conventions 

- input and output file names match except for the last 7 characters 

Error returned from script 

- the script and executable are linked into the directory where the 
program is run 

- disk space is available 


11.6 Recovery Steps 

If met util terminates with an error: 

1) Review error and status messages on stdout to detennine source or location of prob- 
lem. Use Table 11-3 above for assistance. 

2) Correct the problem 

3) Remove previous output fries 

4) Re-run the software 

In case of a problematic error, which cannot be easily diagnosed, debug versions of met_util 
will be available for test use. This is, however, more of a developer procedure than a user pro- 
cedure. Software users should contact the GSAS Development Team for more instructions 

11.7 Sample met_util Control File 

This control file creates subsetted ANC01 files from the input ANC40 meteorological file. 

= METJJTIL 

INPUT_FI LE=anc4 0_0 0 0_2 0 0 0 010 1_1 2 0 0 0 0_0 0 01 . dat 
INPUT_FILE=anc 0 7_0 0 0_0 0_0 0 0 0. dat 
INPUT_FI LE=anc 0 7_0 0 0_0 0_0 0 0 6 .dat 

OUTPUT_FILE=anc 0 1_0 0 0_2 0 0 0 010 1_1 2 0 0 0 0_0 1_0 0 0 0 . dat 
OUTPUT_FILE=anc 0 1_0 0 0_2 0 0 0 010 1_1 2 0 0 0 0_0 1_0 0 01. dat 
OUTPUT_FILE=anc 0 1_0 0 0_2 0 0 0 010 1_1 2 0 0 0 0_0 1_0 0 02.dat 
OUTPUT FILE=anc01 000 20000101 120000 01 0003.dat 


Version 7.0 


Page 11-4 


March 2013 






met util 


The GLAS Science Algorithm Software (GSAS) User’s Guide 


OUTPUT FILE=anc01 000 20000101 120000 01 0004.dat 
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Section 12 

reforbit util 


12.1 Function 

This utility, reforbit_util, processes a given Reference Orbit file (ANC26) for all ascending 
equatorial crossings. Each ascending equatorial crossing will be given a track number. The 
first track west of Greenwich (or on Greenwich) will be assigned a Track number of 1 and its 
time will be determined. All consecutive tracks after that (in increasing time order) will be 
assigned numbers 2, 3, 4, and so on. All tracks that were to the right of Track 1, will be 
wrapped around the last track on the left and numbered accordingly. 

This routine will also create an ECS NOSE file. The NOSE track file will be created from the 
along track locations. The routine will (starting from Track 1) scroll the along track locations 
at 161 second time increments. These increments correspond to 10 degree latitude incre- 
ments. Polygons of approximately one km width in the longitude direction, and a ten degree 
length in the longitudinal direction will be created. These polygons will be tangental, with 
the end of the last polygon for track number n being the beginning of the first polygon for 
track number n+1. ECS requires track numbers to be sequential between the NOSE files. 
Therefore, a standalone routine, adjustNOSETrkNum, will be used to add an offset to the 
track number. 

reforbitutil uses a modified version of the standard GSAS control file. The fonnat of the 
reforbit_util control file will be fully documented in a later subsection. reforbit_util does not 
use an ANC06 file, has no processing control and no time selection capabilities. 

reforbit util should be run before executing GLAS L1 A, GLAS Alt or GLASAtm (which 
require SDMS to provide orbit information) for the corresponding span of data. 

12.2 Input Files 

Table 12-1 lists the inputs files to reforbit util. Refer to the “Interface Control Document 
Between I-SIPS/ISF and CSR” for a description of the Reference orbit file. All of these files 
must be specified and named according to GSAS file naming conventions. 


Table 12-1 reforbit util Inputs 


File Spec 

Type 

Source 

Short Description 

anc26*.dat 

Dynamic Ancillary 

UTexas 

Reference Orbit file. 

anc07*_0000.dat 

Static Ancillary 

Science Team 

GLAS error file. 

anc07MD006.dat 

Static Ancillary 

Science Team 

GLAS Utility constants file. 

Control File 

Control 

ISIPS Operations 

Control file. 
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12.2.1 Control File 

The reforbit_util control file is a modified version of the standard GSAS control file. The 
basic format of this file is documented in Section 5 of this document. reforbit_util does not use 
the common elements used in other GSAS control files. 

The control file section delimiter for reforbitutil is: 

=ref orbit_util 

The only keywords reforbit_util uses are “INPUT_FILE”, “INPUT_ERR”, 

“OUTPUT FILE 1 ”, “OUTPUTFILE2”, “OUTPUT FILE3 ” and the control file section 
delimiter. These keyword specifications do not have start time and stop times. The keywords 
are used for the following designations: 


Table 12-2 reforbit util Keywords 


Keyword 

Value 

INPUTFILE 

Input reference orbit filename. 

INPUTERR 

ANC07 error filename 

OUTPUTFILE1 

output ANC22 reference orbit filename 

OUTPUTFILE2 

SCF track file name (ANC 43) 

OUTPUT_FILE3 

NOSE track file name(ANC28) 


12.3 Output Files 

reforbit_util creates three files as output. The first file is an ASCII file (reference orbit track 
file), which contains the ascending node longitude and track number. The first record con- 
tains the average period of the tracks (in seconds), and the number of tracks in the reference 
orbit file. All subsequent records contain the longitude (in degrees E longitude), the track 
number, time in seconds relative to Track 1, the actual MJD time (in days), and the seconds of 
day. 

The second file is in Fortran direct access format, with each record being 46412 bytes. This 
file is used by the SCF. It contains the 1 -second along track locations for each track in the 
reference orbit file. Each 46412 byte record will contain 5801 latitudes (4-bytes each), 5801 
longitudes (4-bytes each), and a 4-byte delta time. There will be one record for each track. The 
latitudes and longitudes are 1 -second locations along each track from the start of the track to 
the end. The delta time indicates the time interval along the tracks (in this case 1 second). 

The third file is an ASCII ECS NOSE track file. The fonnat of the NOSE track is as follows: 

A|3|track_l|block_l 

B|ptl_lat|ptl_lon|0 

B |pt2_lat |pt2_lon| 0 

B|pt3 lat|pt3_lon|0 
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B | pt4 lat | pt4_lon 1 2 

Where, 

• Items in bold are fixed for ECS purposes, 

• Longitudes (Ion) values are expressed in decimal degrees (4 radix places), with values 
in the range [-180.0000° .. +180.0000°] [+E] 

• Latitude (lat) values are expressed in decimal degrees (4 radix places), with values in 
the range [-90.0000° .. +90.0000°] [+E] 

• Repeat A,B,B,B,B records for all blocks (polygons) per track, and all tracks 

• Points shall be ordered in a clockwise fashion, with no intersecting edges. 


Table 12-3 reforbitutil Outputs 


File Spec 

Type 

Destination 

Short Description 

anc22*.dat 

Dynamic Ancillary 

SDMS/Archive 

Reference orbit file. 

N/A 

Dynamic Ancillary 

SCF 

SCF track file. 

N/A 

Dynamic Ancillary 

ISIPS 

NOSE track file 


12.4 Startup and Termination 

This is an overview of the steps necessary to run reforbit util. Specific operational procedures 
for each of the supported scenarios are provided in the ISIPS Operational Procedures Manual. 

12.4.1 Setup a Runtime Directory 

The suggested method of running reforbit_util is to create a temporary directory and link all 
necessary files into it. The SDMS will create a temporary directory and link all necessary files 
into it. For example, to setup a reforbit_util run, one would perform the following steps (Des- 
ignate TEMPDIR as the temporary directory and DATA DIR as the location in which input 
data for this job has been staged): 

mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/reforbit_util. 

In -s $GLAS_HOME/lib/*. 

In -s $GLAS_HOME/data/anc*.dat. 

In -s $DATA_DIR/* .dat. 

12.4.2 Create a Control File 

reforbit_util is designed to take the name of a control file as a command-line argument. The 
suggested method of creating a control file is by copying a template from the 
$GLAS_HOME/data directory and modifying it with desired input/output filenames and data 
processing options. 
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cp $GLAS_HOME/data/cf_reforbit_util.ctl ./control _ file name 
vi ./controlfilename 

12.4.3 Run the PGE 

Error and status messages will be displayed on the screen (stdout) and recorded in the ANC06 
fde. 

./met_util control Jilejiame 

12.4.4 Run-Time Statistics 

reforbit_util processes one orbit file in less than a minute. This may vary due to hardware load 
and data dependencies. 

12.4.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. Standard 
output (stdout) must be examined to determine runtime success. Additionally, the process will 
return a result code to the operating system which may be used to programatically detennine 
success or failure (0=success, 3=fatal error). 

12.5 Error and Warning Messages 

Fatal errors are generated if there is a problem opening or reading a file. When an error 
occurs, an error message is printed to the standard output. It includes the error number, sever- 
ity, process name where the error occurred, a short description, and the file name if the error 
occurred while accessing a file. 

Errors possible from reforbit util with the severity and frequency include: 


ERROR= -10001 Error Opening File for Input 3 1 
ERROR= - 1 0 0 0 2 No control file specified 3 1 
ERROR=- 10006 Error Opening File for Output 3 1 
ERROR= - 1 0 0 1 4 Unrecognized line in control file 3 1 
ERROR= - 1 0 0 1 7 I/O Error Reading Control File 3 1 
ERROR=-10029 Error Returned From Script 3 1 
ERROR=-50008 Value of cosine GT 1.0 in Geoloc 2 1 
ERROR=-50009 Value of cosine Lt -1.0 in Geoloc 2 1 
ERROR= -50010 Max Iterations exceeded in Geoloc 2 1 


ERROR=-50013 Error reading 10 consec recs in POD file3 1 
The error severity and frequency may be modified as described in the error section. 
Explanations of these errors follow: 
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Table 12-4 Error Resolution 


Error Type 

Ensure that: 

No control file specified 

- control file name is typed correctly on command line 

Reading File 

- file is available 

- file is not corrupt - regenerate if necessary 

Unrecognized line in control 
file 

- keywords have not been changed in control file 

- extraneous lines have not been added to control file 


12.6 Recovery Steps 

If reforbit_util terminates with an error: 

1) Review error and status messages on stdout to detennine source or location of prob- 
lem. Use Table 12-4 above for assistance. 

2) Correct the problem 

3) Remove previous output fdes 

4) Re-run the software 

In case of a problematic error, which cannot be easily diagnosed, debug versions of 
reforbit_util will be available for test use. This is, however, more of a developer procedure 
than a user procedure. Software users should contact the GSAS Development Team for more 
instructions 

12.7 Sample reforbit_util Control File 

This control file creates the ANC22 reference orbit file from the ANC26 input file. 

= ref orbit_util 

INPUT_FILE=anc2 6_0 0 0_2 0 0 0 010 1_12 0 0 0 0_0 0 01. dat 
INPUT_ERR= anc07_000_00_0000.dat 

OUTPUT_FI LEI = anc2 2_0 0 0_2 0 0 0 010 1_1 2 0 0 0 0_0 0 01 . dat 
OUTPUT_FI LE2 =anc4 3_2 0 0 0 010 1_1 2 0 0 0 0_0 0 0 1 . dat 
OUTPUT FILE3=anc28 20000101 120000 0001.dat 


March 2013 


Page 12-5 


Version 7.0 






The GLAS Science Algorithm Software (GSAS) User’s Guide 


reforbit util 


Version 7.0 


Page 12-6 


March 2013 



Section 13 

createGranule util 


13.1 Function 

This utility, createGranutil, processes a given Predicted Orbit file and using a Reference 
Orbit ID file, creates 1/4 rev, 2 rev, and 14 rev granules. This utility will call the createGran- 
ule subroutine to create two scratch files (a rev file, and a granule file). The rev file will con- 
tain all the ascending equatorial crossings determined from the predicted orbit file. The 
granule file will contain the +/- 50 degree latitude crossings. The +/-50 degree latitude cross- 
ings will be designated by segment numbers. The segment numbers are defined in Table 13-1. 


Table 13-1 Segment Description 


Segment 

Description 

Segment 1 

start of +50 degree latitude crossing (on the ascending portion of the track), 

Segment 2 

start of +50 degree latitude crossing (on the descending portion of the track), 

Segment 3 

start of a -50 degree latitude crossing (on the descending portion of the track), 

Segment 4 

start of a -50 degree latitude crossing (on the ascending portion of the track). 


This utility will then check the operation mode selected (i.e., Predict or Reference). If the 
Reference mode is selected, then this utility will call the update refTab subroutine to calculate 
the begin track, and time into begin track for the relevant reference orbit files. The Reference 
Orbit ID file (which is an input to this routine) will be updated with this new information. If 
the Predict mode is selected, then the calc granules subroutine will be invoked. This routine 
will calculate the 1/4 rev, 2 rev, and 14 rev granule infonnation on the basis of information 
contained in the Reference Orbit ID file and Predicted Orbit file. The calculated granule infor- 
mation will be written to user specified files. The information from the 1/4 rev granules will 
be used along with the appropriate track file to generate a SCF rev file. The SCF rev file will 
list the rev numbers, start times of each track as well as the reference orbit repeat ground track 
phase, reference orbit number and instance 

createGran util uses a modified version of the standard GSAS control file. The format of the 
createGran util control file will be fully documented in a later subsection. createGran util 
does not use an ANC06 file, has no processing control and no time selection capabilities. 

createGran util should be run before executing GLAS L1A, GLAS Alt or GLAS Atm 
(which require SDMS to provide segment information) for the corresponding span of data. 

13.2 Input Files 

Table 13-2 lists the inputs files to createGran util. Refer to the “Interface Control Document 
Between I-SIPS/ISF and CSR” for a description of the Predicted orbit file. All of these files 
must be specified and named according to GSAS file naming conventions. 
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Table 13-2 createGran util Inputs 


File Spec 

Type 

Source 

Short Description 

anc22*.dat 

Dynamic Ancillary 

UTexas 

Predicted Orbit file. 

anc42*.dat 

Dynamic Ancillary 

ISIPS 

Reference orbit table. 

anc07MD000.dat 

Static Ancillary 

Science Team 

GLAS error file. 

anc25*.dat 

Dynamic Ancillary 

Science Team 

GPS/UTC conversion file. 

Control File 

Control 

ISIPS Operations 

Control file. 


13.2.1 Control File 

The createGran util control file is a modified version of the standard GSAS control file. The 
basic format of this file is documented in Section 5 of this document. createGran util does not 
use the common elements used in other GSAS control files. 

The control file section delimiter for createGran util is: 

=createGran_util 

createGran util keyword file specifications do not have start time and stop times. 
createGran util uses the following keywords: 


Table 13-3 createGran util Keywords 


Keyword 

Value 

INREFORBFILE 

Reference orbit ID file name. 

INPREDORBFILE 

Predicted orbit table file name. 

INERRORFILE 

Ancillary error file name. 

INANC25FILE 

it is the GPS/UTC conversion file 

LASTTRACK 

it is optional, but should be used when in transfer orbit 
mode 

OUTREFORBFILE 

Reference orbit ID file name. 

OUTQRTREVFILE 

quarter rev file name. 

OUT2REVFILE 

two rev file name. 

OUT_14REVFILE 

fourteen rev file name 

OUT_SCFREVFILE 

SCF rev file name 

PROC_MODE 

Processing mode (i.e. PREDORB or REFORB) 
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Table 13-3 createGranutil Keywords (Continued) 


Keyword 

Value 

STARTTM 

POD start time (J2000 secs) 

STOPTM 

POD stop time (J2000 secs) 


When running in REFORB mode, the INREFORBFILE, IN_PREDORBFILE, 
INERRORFILE, IN ANC25FILE, OUT REFORBFILE, PROCMODE, STARTTM, and 
STOPTM keywords are required. For the PREDORB mode, the IN REFORBFILE, 

IN PREDORBFILE, IN ERRORFILE, IN ANC25FILE, OUT QRTREVFILE, 

OUT 2REVFILE, OUT14REVFILE, OUT SCFREVFILE, PROC MODE, START TM, 
and STOP TM keywords are required. The LAST TRACK keyword is optional, and is only 
used when in the transfer orbit mode. The value of the last track will be the last track that was 
processed by the predicted orbit fde for the previous day. 

13.3 Output Files 

Four ASCII files are the primary output. The first file (called the quarter rev file) contains the 
quarter rev start time (in J2000 seconds), repeat ground track phase, reference orbit number, 
instance, product type (1 for quarter rev granule), cycle number, track number, and segment 
number for all the quarter rev granules determined from the predicted orbit file. The next 
ASCII file (the two rev file) contains the two rev start time (in J2000 seconds), repeat ground 
track phase, reference orbit number, instance, product type (2 for two rev granule), cycle 
number, track number, and segment number for all the two rev granules detennined from the 
predicted orbit file. The third ASCII file (the fourteen rev file) contains the fourteen rev start 
time (in J2000 seconds), repeat ground track phase, reference orbit number, instance, prod- 
uct type (3 for two rev granule), cycle number, track number, and segment number for all the 
fourteen rev granules determined from the predicted orbit file. The fourth ASCII file (called 
the SCF rev file) contains the relative rev numbers, starting from 1 (during each execution), 
that were determined from the given predicted orbit file. It also contains the start time, repeat 
ground track phase, reference orbit number, instance, cycle number, and track number for all 
the equator crossings determined from the predicted orbit file. 

Additionally, two ASCII scratch files will be created by the createGran util Utility. The first 
file will be a rev file, which will contain the rev times and longitudes. Each row of this file 
will contain the time (in J2000 secs), latitude, and longitude of the ascending equatorial cross- 
ings. The other file will be a granule file, which will have the segment crossing times, and 
locations (latitudes and longitudes), as well as the segment numbers. Each line of the granule 
file will contain the start time (in J2000 secs), the latitude, longitude, and the segment number 
of a granule respectively. The first two rows will have a segment number of 10 and 1 1 respec- 
tively. These granules list the start and end times of the predicted orbit file respectively. For a 
two day predicted orbit file, the rev scratch file should be about 2 Kbytes, while a granule 
scratch file should be about 7Kbytes. 


March 2013 


Page 13-3 


Version 7.0 




The GLAS Science Algorithm Software (GSAS) User’s Guide 


createGranule util 


13.4 Startup and Termination 

This is an overview of the steps necessary to run createGranutil. Specific operational proce- 
dures for each of the supported scenarios are provided in the ISIPS Operational Procedures 
Manual. 

13.4.1 Setup a Runtime Directory 

The suggested method of running createGran util is to create a temporary directory and li nk 
all necessary files into it. The SDMS will create a temporary directory and link all necessary 
files into it. For example, to setup a createGran util run, one would perfonn the following 
steps (Designate TEMPDIR as the temporary directory and DATADIR as the location in 
which input data for this job has been staged): 

mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/createGran_util. 

In -s $GLAS_HOME/lib/* . 

In -s $ G LAS HOME/ data/ a n c * . dat . 

In -s $DATA_DIR/*.dat. 

13.4.2 Create a Control File 

createGran util is designed to take the name of a control file as a command-line argument. 
The suggested method of creating a control file is by copying a template from the 
$GLAS_HOME/data directory and modifying it with desired input/output filenames and data 
processing options. 

cp $GLAS_HOME/data/cf_creategran.ctl ./control file name 
vi ./control 'Jilejiame 

13.4.3 Run the PGE 

Error and status messages will be displayed on the screen (stdout) and recorded in the ANC06 
file. 


>./createGran_util control Jilejiame 

13.4.4 Run-Time Statistics 

createGran util processes one orbit file in less than a minute. This may vary due to hardware 
load and data dependencies. 

13.4.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. Standard 
output (stdout) must be examined to determine runtime success. Additionally, the process will 
return a result code to the operating system which may be used to programatically detennine 
success or failure (0=success, 3=fatal error). 


Version 7.0 


Page 13-4 


March 2013 



createGranule util 


The GLAS Science Algorithm Software (GSAS) User’s Guide 


13.5 Error and Warning Messages 

Fatal errors are generated if there is a problem opening or reading a file. When an error 
occurs, an error message is printed to the standard output. It includes the error number, sever- 
ity, process name where the error occurred, a short description, and the file name if the error 
occurred while accessing a file. 

Errors possible from createGranutil with the severity and frequency include: 


ERROR= -10001 Error Opening File for Input 3 1 
ERROR= - 1 0 0 0 2 No control file specified 3 1 
ERROR=- 10006 Error Opening File for Output 3 1 
ERROR= - 1 0 0 1 4 Unrecognized line in control file 3 1 
ERROR= - 1 0 0 1 7 I/O Error Reading Control File 3 1 
ERROR=-10029 Error Returned From Script 3 1 
ERROR=-50008 Value of cosine GT 1.0 in Geoloc 2 1 
ERROR=-50009 Value of cosine Lt -1.0 in Geoloc 2 1 
ERROR=-50010 Max Iterations exceeded in Geoloc 2 1 


ERROR=-50013 Error reading 10 consec recs in POD file3 1 

The error severity and frequency may be modified as described in the error section. Explana- 
tions of these errors follow: 

Table 13-4 Error Resolution 


Error Type 

Ensure that: 

No control file specified 

- control file name is typed correctly on command line 

Reading File 

- file is available 

- file is not corrupt - regenerate if necessary 

Unrecognized line in control 
file 

- keywords have not been changed in control file 

- extraneous lines have not been added to control file 


13.6 Recovery Steps 

If createGran util tenninates with an error: 

1) Review error and status messages on stdout to detennine source or location of prob- 
lem. Use Table 13-4 above for assistance. 

2) Correct the problem 

3) Remove previous output files 

4) Re-run the software 
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In case of a problematic error, which cannot be easily diagnosed, debug versions of 
createGran util will be available for test use. This is, however, more of a developer procedure 
than a user procedure. 


13.7 Sample createGran_util Control File (REFORB) 

This control file processes a reference orbit ID file with processing mode set to REFORB. 

=CREATEGRAN_UTIL Control file createGran utility 
IN_REFORBFILE=ref orblDf ile_123 
IN_PREDORBFILE=day3orb . da 

IN_ANC2 5 Fi le=anc2 5_0 0 1_2 002121 3_0 0000 0_0 1_0 0 0 0 . dat 

IN_ERRORFI LE=anc 0 7_0 0 1_0 1_0 0 0 0 . dat 

IN_ERRORFI LE=anc 0 7_0 0 1_0 1_0 0 01 . dat 

OUT_REFORBFILE=ref orblDf ile_123out 

PROC_MODE=REFORB 

START_TM= 173250.0 

STOP_TM= 258945.0 

=END of control file 


13.8 Sample createGran_util Control File (PREDORB) 

This control file processes a reference orbit ID file with processing mode set to PREDORB. 

=CREATEGRAN_UTIL Control file createGran utility 
IN_REFORBFILE=ref orblDf ile_123out 
IN_PREDORBFILE=day3orb . da 

IN_ANC2 5 Fi le=anc2 5_0 0 1_2 002121 3_0 0000 0_0 1_0 0 0 0 . dat 

IN_ERRORFILE=anc07_001_01_0000 . dat 

IN_ERRORFI LE=anc 0 7_0 0 1_0 1_0 0 01 . dat 

IN_ERRORFI LE=anc 0 7_0 0 1_0 1_0 0 02 .dat 

IN_ERRORFI LE=anc 0 7_0 0 1_0 1_0 0 03 .dat 

IN_ERRORFI LE=anc 0 7_0 0 1_0 1_0 0 04 . dat 

IN_ERRORFI LE=anc 0 7_0 0 1_0 1_0 0 0 5 . dat 

IN_ERRORFI LE=anc 0 7_0 0 1_0 1_0 0 0 6 . dat 

OUT_QRTREVFILE=qrtrevf ile_2 

OUT_2 RE VF ILE=tworevf il e_2 

OUT_14REVFILE=f teenrevf ile_2 

OUT_SCFREVFILE=SCFrevf ile_2 

PROC_MODE= PREDORB 

START_TM= 173250.0 

STOP_TM= 258945.0 

=END of control file 
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14.1 Function 

Atmanc reads a GLA02 product file and computes 532 nm and 1064 nm calibration coeffi- 
cients for specified-time segments. The coefficients per segment are output to an ancillary 
(ANC36) file which is used in the level IB atmosphere data processing. A second ancillary 
file (ANC44) contains the 532 and 1064 data for clouds that were detected above about 10 
km. The file is intended to be used for the calibration of the 1064 channel, which will be done 
separately by the science team, outside of normal ISIPS processing. 

This utility perfonns an intermediary step between the atmosphere level 1 A and level IB data 
processing. It reads the GLA02 product file output from the atmosphere level 1A processing 
and creates a file containing data used by the atmosphere level IB data processing. This file 
contains 532 nm and 1064 nm calibration coefficients calculated over specified-time seg- 
ments. This is achieved by summing 532 nm and 1064 nm lidar data over each second of the 
GLA02 product file for a specified time. Once the time has been reached, the data is averaged 
for the segment. Standard atmosphere and meteorological (MET) data are retrieved and aver- 
age 532 nm and 1064 nm molecular backscatter values are computed for each segment. Aver- 
aged 532 nm ozone transmissions are also computed for each segment. From these data, the 
532 nm and 1064 nm calibration coefficients are calculated. The calibration coefficients, 
molecular backscatter, and ozone transmissions for each segment are written to the ancillary 
output file. 

atm anc uses a modified version of the standard GSAS control file. The format of the 
atm anc control file will be fully documented in a later subsection, atm anc does not use an 
ANC06 file, has no processing control and no time selection capabilities. 

atm anc should be run after executing metutil and GLAS L1A, but before executing 
GLAS_Atm (which requires the ANC36 and ANC44 files) for the corresponding span of data. 
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14.2 Input Files 

. Input files consist of the GLA02 product file, the standard atmosphere data file (ANC 18), the 


Table 14-1 atm_anc Inputs 


File Spec 

Type 

Source 

Short Description 

anc01*_??.dat 

Dynamic Ancillary 

met_util 

Subsetted MET files. There is a 
separate MET file per MET data 
type. All of the MET files must 
be specified. 

anc07MD000.dat 

Static Ancillary 

Science Team 

GLAS error file. 

anc07MD002.dat 

Static Ancillary 

Science Team 

GLAS atmosphere constants 
file. 

anc18*.dat 

Static Ancillary 

Science Team 

Standard Atmosphere file 

anc35*.dat 

Static Ancillary 

Science Team 

Ozone file 

Control File 

Control 

ISIPS Operations 

Control file. 

gla02*.dat 

LI A Product 

GLAS_L1A 

GLAS LI A Atmosphere product 
file. 


ozone data file (ANC35), the MET data files (ANC01), and the ancillary (ANC07) files which 
contain constants used by the program and error numbers available to the program. Note that a 
full 12 hours of MET data (2 sets of files) must be specified. Table 14-1 lists the inputs files to 
atmanc. All of these files must be specified and named according to GSAS file naming con- 
ventions 

14.2.1 Control File 

The atm anc control file is a modified version of the standard GSAS control file. The basic 
format of this file is documented in Section 5 of this document, atm anc does not use the com- 
mon elements used in other GSAS control files. 

The control file section delimiter for atm anc is: 

=atm_anc 

The only keywords atm anc uses are “INPUT FILE”, “OUTPUT FILE” and the control file 
section delimiter. 

14.3 Output Files 

The software creates ANC36 and ANC44 output files. 

14.3.1 ANC36 

The ANC36 output file contains 23 values per segment: 
first latitude 
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Table 14-2 atm_anc Outputs 


File Spec 

Type 

Destination 

Short Description 

anc36*.dat 

Dynamic Ancillary 

GLAS_Atm/Archive 

Atmosphere Calibration file. 

anc44*.dat 

Dynamic Ancillary 

Science Team 

Atm 1064 Cirrus CAL File 


first longitude 
last latitude 
last longitude 
first record index 
first time (J2000 sec) 
last time (J2000 sec) 

532 calibration coefficient at the high calibration height 

532 calibration coefficient at the low calibration height 

1064 calibration coefficient at the low calibration height 

average 532 lidar value at the high calibration height 

average 532 lidar value at the low calibration height 

average 1064 lidar value at the low calibration height 

average 532 molecular backscatter value at the high calibration height 

average 532 molecular backscatter value at the low calibration height 

average 1064 molecular backscatter value at the low calibration height 

average 532 ozone transmission value at the high calibration height 

average 532 ozone transmission value at the low calibration height 

average 532 background 

high calibration height (m) 

high calibration band width (m) 

low calibration height (m) 

low calibration band width (m) 

The number of segments is the first number in the file. 

An example of the output file follows: 

2 

first lat first Ion last lat last Ion 

rec_index first_time last_time ccof_ghi ccof_glo ccof_irlo 

lid_ghi lid_glo lid_irlo mol_ghi mol_glo 

mol irlo 
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oz_ghi oz_glo g_bkgrd cht_hi hi_wid cht_lo 

lo wid 


50.1268 354.2534 84.9712 306.0022 

30010. 3001. 3589. 3.513E+13 4.695E+13 5.684E+02 

7 . 952E+05 1 . 274E+07 1.021E-05 2.281E-08 2.795E-07 1.797E-08 

9 . 92 IE- 01 9.712E-01 5.509E+00 30000.00 2000.00 14848.00 2000.00 

36010. 3601. 4189. 3 . 924E+13 5.412E+13 

9 . 802E+02 

8 . 847E+05 1 . 265E+07 1.516E-05 2.264E-08 2.413E-07 1.547E-08 

9 . 961E- 01 9 . 686E-01 5.510E+00 30000.00 2000.00 14848.00 2000.00 

The output file is meant to be used by the GSAS atmosphere level IB data processing rou- 
tines. These routines read the ANC36 file and interpolate the 532 nm and 1064 nm calibration 
coefficients per segment to once per second. These coefficients are then used to compute the 
532 nm and 1064 nm backscatter cross section profiles at once per second for use in the atmo- 
sphere level 2 data processing. 

The ANC36 file must be named according to standard GSAS naming conventions 

14.3.2 ANC44 

For each cloud above ‘GDCIRRUSHT’ the ANC44 file contains a header line followed by 
‘GICIRRUSBINS’ bins of 532 and 1064 NRB (GLA02) data, averaged to 1 second. The 
header line contains the time, latitude, longitude, cloud height, bin number of the first bin 
printed out and the number of bins printed out. There can be many clouds for a given granule, 
so the size of each ANC44 file can be considerable (1 MB or so). 

An example of the ANC44 output for one cloud follows: 

51890013. 50.127 354.585 13285.400 360 6 

4 . 37720000D+06 3 . 5 034 0 0 0 0D- 05 

9.44040000D+06 8 . 62 5 0 0 0 0 0D- 05 

8 . 54600000D+06 - 5 . 03 0 0 0 0 0 0D- 06 

4 . 14280000D+06 8 . 4 06 8 0 0 0 0D- 05 

7 . 54640000D+06 7 . 2 95 0 0 0 0 0D- 05 

3 . 51900000D+06 5 . 5 13 8 0 0 0 0D- 05 

14.4 Startup and Termination 

This is an overview of the steps necessary to run atmanc. Specific operational procedures for 
each of the supported scenarios are provided in the ISIPS Operational Procedures Manual. 

14.4.1 Setup a Runtime Directory 

The suggested method of running atm anc is to create a temporary directory and link all nec- 
essary files into it. The SDMS will create a temporary directory and link all necessary files 
into it. For example, to setup a atm anc run, one would perform the following steps (Desig- 
nate TEMPDIR as the temporary directory and DATA DIR as the location in which input 
data for this job has been staged): 

>mkdir $TEMP_DIR 
>cd $TEMP_DIR 

>ln -s $GLAS_HOME/bin/atm_anc. 
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>ln -s $GLAS_HOM E/lib/*. 

>ln -s $GLAS_HOME/data/anc*.dat. 

>ln -s $DATA_DIR/* .dat. 

14.4.2 Create a Control File 

atmanc is designed to take the name of a control file as a command-line argument. The sug- 
gested method of creating a control file is by copying a template from the $GLAS_HOME/ 
data directory and modifying it with desired input/output filenames and data processing 
options. 

>cd $TEMP_DIR 

>cp $G LASHOM E/data/contro Item plate ,/control_file_name 
>vi ./control filename 

14.4.3 Run the PGE 

Error and status messages will be displayed on screen (stdout) and recorded in the ANC06 
file. 

>cd $TEMP_DIR 
>./atm_anc controlfilename 

14.4.4 Run-Time Statistics 

atm anc processes one orbit file in approximately x minutes. This may vary due to hardware 
load and data dependencies. 

14.4.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. Standard 
output (stdout) must be examined to determine runtime success. Additionally, the process will 
return a result code to the operating system which may be used to programmatically detennine 
success or failure (0=success, 3=fatal error). 

14.5 Error and Warning Messages 

Fatal errors are generated if there is a problem opening or reading a file. When an error 
occurs, an error message is printed to the standard output. It includes the error number, sever- 
ity, process name where the error occurred, a short description, and the file name if the error 
occurred while accessing a file. 

Errors possible from atm anc with the severity and frequency include: 

ERROR= -10001 Error Opening File for Input: 31 

ERROR= - 1 0 0 0 2 No control file specified31 

ERROR=-10006 Error Opening File for Output31 

ERROR=-10008 Error Reading File31 

ERROR=-10009 Error Writing File31 

ERROR= - 1 0 0 1 4 Unrecognized line in control file31 
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ERROR=- 10015 Unknown value in keyword/value pair 3 1 

ERROR= - 1 0 0 1 7 I/O Error Reading Control File31 

ERROR=- 10025 Error Reading Standard Atmosphere file header 
3 1 

ERROR=-10026 Error Reading Standard Atmosphere file data 
3 1 

ERROR= -40001 DEM out-of-bounds 150 

ERROR= - 4 0 0 2 4 Invalid value written to ancillary file 11 
ERROR=-40025 Array index is greater than size allowed31 
The error severity and frequency may be modified as described in the error section. 
Explanations of these errors follow: 


Table 14-3 Error Resolution 


Error Type 

Ensure that: 

No control file specified 

- control file name is typed correctly on command line 

Opening File 

- file is available 

- control file reflects the correct file name 

- file name does not exceed 60 characters 

Reading File 

- file is available 

- file is not corrupt - regenerate if necessary 

Writing File 

- file is available 

- disk space is available 

Unrecognized line in control 
file 

- keywords have not been changed in control file 

- extraneous lines have not been added to control file 

Unknown value in keyword/ 
value pair 

- input and output file names in control file conform to their correct 
naming conventions 

Array index is greater than 
size allowed 

- the dimension of the array is sufficient for the data it needs to con- 
tain 

- the amount of data is not too large for the array 


14.6 Recovery Steps 

If atm anc terminates with an error: 

1) Review error and status messages on stdout to detennine source or location of prob- 
lem. Use Table 14-3 above for assistance. 

2) Correct the problem 

3) Remove previous output files 

4) Re-run the software 
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In case of a problematic error, which cannot be easily diagnosed, debug versions of atmanc 
will be available for test use. This is, however, more of a developer procedure than a user pro- 
cedure. 


14.7 Sample atm anc Control File 

=ATM_ANC 

INPUT_FILE=GLA02_002_22_01005_2331_0_01_0000 . DAT 
INPUT_FILE=ANCO 1_0 0 0_2 0 010 82 3_12 0 0 0 0_0 1_0 0 0 0. DAT 
INPUT_FILE=ANC0 1_0 0 0_2 0 010 82 3_12 0 0 0 0_0 1_0 0 01. DAT 
INPUT_FILE=ANC0 1_0 0 0_2 0 010 82 3_12 0 0 0 0_0 1_0 0 02. DAT 
INPUT_FILE=ANC0 1_0 0 0_2 0 010 82 3_12 0 0 0 0_0 1_0 0 03. DAT 
INPUT_FILE=ANC0 1_0 0 0_2 0 010 82 3_12 0 0 0 0_0 1_0 0 04. DAT 
INPUT_FILE=ANC0 1_0 0 0_2 0 010 82 3_1 8 0 0 0 0_0 1_0 0 0 0. DAT 
INPUT_FILE=ANC01_000_20010823_180000_01_0001 . DAT 
INPUT_FILE=ANC01_000_20010823_180000_01_0002 . DAT 
INPUT_FILE=ANC01_000_20010823_180000_01_0003 . DAT 
INPUT_FILE=ANC0 1_0 0 0_2 0 010 82 3_1 8 0 0 0 0_0 1_0 0 04. DAT 
INPUT_FILE=ANC0 1_0 0 0_2 0 010 8 24_0 0 0 0 0 0_0 1_0 0 0 0. DAT 
INPUT_FILE=ANC0 1_0 0 0_2 0 010 8 24_0 0 0 0 0 0_0 1_0 0 01. DAT 
INPUT_FILE=ANC0 1_0 0 0_2 0 010 8 24_0 0 0 0 0 0_0 1_0 0 02. DAT 
INPUT_FILE=ANC0 1_0 0 0_2 0 010 8 24_0 0 0 0 0 0_0 1_0 0 03. DAT 
INPUT_FILE=ANC0 1_0 0 0_2 0 010 8 24_0 0 0 0 0 0_0 1_0 0 04. DAT 
INPUT_FILE=anc07_001_01_0000 . dat 
INPUT_FILE=anc07_001_01_0001 . dat 
INPUT_FILE=anc07_001_01_0002 . dat 
INPUT_FILE=anc07_0 01_01_0 0 03 .dat 
INPUT_FILE=anc07_001_01_0006 . dat 
INPUT_FILE=anc07_001_01_0005 . dat 
INPUT_FILE=anc07_002_01_0004 . dat 
INPUT_FILE=ancl 8_0 0 1_0 1_0 0 0 0. dat 
INPUT_FILE=anc3 5_0 0 1_0 1_0 0 0 0. dat 

OUTPUT_FILE=ANC3 6_0 0 2_2 2_0 10 0 5_2 3 3 1_0_0 1_0 0 00. DAT 
OUTPUT FILE=ANC44 002 22 01005 2331 0 01 0000.DAT 
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GLAS Meta 


15.1 Function 

GLAS_Meta reads ANC45 and ANC46 metadata input files and, using the parsed informa- 
tion, reads the header records of GLAS product and ancillary files to create ECS-compliant 
inventory-level metadata files. GLASMeta may be either run immediately after specific 
product files have been generated or just before sending batches of product/ancillary files for 
distribution. GLAS Meta allows for multiple-file/multi-granule input and output files. 

15.2 Input Files 

Table 15-1 lists the inputs to GLAS Meta. Files which are specific to GLAS Meta are docu- 
mented in this section. See the appropriate section of this document or the GLAS Data Prod- 
ucts Specifications Volumes for details regarding the those files not specific to GLAS Meta. 


Table 15-1 GLAS Meta Inputs 


File Spec 

Type 

Source 

Short Description 

glafdat 

GLAS Products 

GSAS 

GLAS product files. 

anc45*.dat 

Static Ancillary 

Science Team 

Product metadata input files. 

anc04*.dat 

Dynamic Ancillary 

UTexas 

IERS Polar Motion and Earth 
Rotation Data File. 

anc46*_0004.dat 

Static Ancillary 

Science Team 

Ancillary metadata input file for 
ANC04. 

anc08*.dat 

Dynamic Ancillary 

UTexas 

Precision Orbit file. 

anc46*_0008.dat 

Static Ancillary 

Science Team 

Ancillary metadata input file for 
ANC08. 

anc09*.dat 

Dynamic Ancillary 

UTexas 

Precision Attitude file. 

anc46*_0009.dat 

Static Ancillary 

Science Team 

Ancillary metadata input file for 
ANC09. 

anc20*.dat 

Dynamic Ancillary 

UTexas 

Predicted orbit file. 

anc46M3020.dat 

Static Ancillary 

Science Team 

Ancillary metadata input file for 
ANC20. 

anc22*.dat 

Dynamic Ancillary 

ISIPS 

Track file. 

anc46M3022.dat 

Static Ancillary 

Science Team 

Ancillary metadata input file for 
ANC22. 

anc25*.dat 

Dynamic Ancillary 

Science Team 

GPS/UTC conversion file. 
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Table 15-1 GLASMeta Inputs (Continued) 


File Spec 

Type 

Source 

Short Description 

anc46*_0025.dat 

Static Ancillary 

Science Team 

Ancillary metadata input file for 
ANC25. 

anc33*.dat 

Dynamic Ancillary 

Science Team 

UTC time conversion file. 

anc46*_0033.dat 

Static Ancillary 

Science Team 

Ancillary metadata input file for 
ANC33. 

anc37*.dat 

Dynamic Ancillary 

UTEXAS 

Spacecraft CG file. 

anc46*_0037.dat 

Static Ancillary 

Science Team 

Ancillary metadata input file for 
ANC37. 

anc39*.dat 

Dynamic Ancillary 

UTEXAS 

GPS file. 

anc46*_0039.dat 

Static Ancillary 

Science Team 

Ancillary metadata input file for 
ANC39. 

anc07*_0001 .dat 

Static Ancillary 

Science Team 

GLAS global constants file. 

Control File 

Control 

ISIPS Operations 

Control file. 


15.2.1 ANC45 Product Metadata Input Files 

ANC45 Metadata input files are text-based templates created from ESDTs (Earth Science 
Data Types). The GLAS team collaborated with NSIDC to create ESDTs for each product and 
each ancillary product. Within the ESDT are collection-level and inventory-level metadata. 
Only the inventory-level metadata is present in the ANC45 files. 

Each ANC45 filetype corresponds to the similarly numbered GLA product file. The files are 
parsed and empty fields are filled in from values present in the appropriate product header 
records. 

Note that a single ANC04*_04 file is used for GLA 04 processing and only the 
GLA04*_06.dat file is required to satisfy the GLA04 metadata processing requirements. 

15.2.2 ANC46 Ancillary Metadata Input Files 

ANC46 Metadata input files are text-based templates created from ESDTs (Earth Science 
Data Types). The GLAS team collaborated with NSIDC to create ESDTs for each product and 
each ancillary product. Within the ESDT are collection-level and inventory-level metadata. 
Only the inventory-level metadata is present in the ANC46 files. 

Each ANC46 filetype corresponds to the similarly numbered ancillary file. The files are 
parsed and empty fields are filled in from values related to the target ancillary file. 

15.2.3 Control File 

The control file fonnat and common elements are documented in Section 5 of this document. 
Elements specific to GLAS Meta are described in this section. 

The control file section delimiter for GLAS Meta is: 
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=GLAS_Meta 

Since GLAS Meta has no requirement for execution scenarios, there are no unique keywords 
for the GLAS Meta control file. GLAS Meta will perform all functions based on the pres- 
ence of input and output files within the control file. 


15.3 Output Files 

Table 15-2 lists the outputs created by GLAS_Meta. Files which are specific to GLAS_Meta 
are documented in this section. See the appropriate section of this document or the GLAS 
Data Products Specifications Volumes for details regarding the files which are not specific to 
GLAS Meta. 


Table 15-2 GLAS Meta Outputs 


File Spec 

Type 

Destination 

Short Description 

glafmet 

Metadata 

ECS 

ECS-compliant metadata inven- 
tory files. 

anc04*.met 

Metadata 

ECS 

IERS Polar Motion and Earth 
Rotation metadata File. 

anc08*.met 

Metadata 

ECS 

Precision Orbit metadata file. 

anc09*.met 

Metadata 

ECS 

Precision Attitude metadata file. 

anc20*.met 

Metadata 

ECS 

Predicted orbit metadata file. 

anc22*.met 

Metadata 

ECS 

Track metadata file. 

anc25*.met 

Metadata 

ECS 

GPS/UTC conversion metadata 
file. 

anc33*.mett 

Metadata 

ECS 

UTC time conversion metadata 
file. 

anc37*.met 

Metadata 

ECS 

Spacecraft CG metadata file. 

anc39*.met 

Metadata 

ECS 

GPS metadata file. 

anc06*.txt 

Dynamic Ancillary 

ISIPS Operations 

Standard metadata/processing 
log file. 


15.3.1 GLA Metadata Files 

GLAS metadata files are required to enable ECS to ingest GLAS products into their system. 
One metadata file must be generated for each GLAS product file delivered to ECS. Each 
GLAS product file type has a corresponding metadata file type (eg: gla()5*.met corresponds to 
gla05*.dat). The exception is GLA04. Whereas GLA04 is a multi-file granule, a single meta- 
data file is sufficient for each GLA04 granule. The gla04*_06.dat file should be used as input 
and gla04*06.met as output when processing GLA04 metadata information. 
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15.4 Processing and Reprocessing Scenarios 

GLAS_Meta supports only a full-processing scenario. All processing is based on the presence 
of input and output files within the control file. 

Additionally, time-selected processing is not supported. The start and stop times on the 
INPUTFILE and OUTPUTFILE control file entries are ignored for processing. 


15.5 Startup and Termination 


This is an overview of the steps necessary to run GLAS_Meta. 

15.5.1 Setup a Runtime Directory 

The suggested method of running GLASMeta is to create a temporary directory and link all 
necessary files into it. The SDMS will create a temporary directory and link all necessary files 
into it. For example, to setup a GLAS Meta run, one would perform the following steps (Des- 
ignate TEMPDIR as the temporary directory and DATADIR as the location in which input 
data for this job has been staged): 


mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/GLAS_Meta . 
In -s $GLAS_HOME/lib/* . 

In -s $GLAS_HOME/data/anc07* .dat 
In -s $GLAS_HOME/ data/ anc45* . dat 
In -s $DATA_DIR/* .dat . 


15.5.2 Create a Control File 


GLAS Meta is designed to take the name of a control file as a command-line argument. The 
suggested method of creating a control file is by copying a template from the 
$GLAS_HOME/data directory and modifying it with desired input/output filenames and data 
processing options. 

cp $GLAS_HOME/data/cf_glas_meta . ctl . / control_file_name 
vi . / control_file_name 

15.5.3 Run the PGE 


Error and status messages will be displayed on the screen (stdout) and recorded in the ANC06 
file. 


. /GLAS_Meta control_f ile_name 

15.5.4 Run-Time Statistics 

GLAS Meta has minimal processing requirements since it only parses the product header 
records. 

15.5.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. The log/ 
metadata file (ANC06*) must be examined to determine runtime success. Additionally, the 
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process will return a result code to the operating system which may be used to programatically 
detennine success or failure (0=success, 3=fatal error). 

15.6 Error and Warning Messages 

All GSAS error and warning messages are listed numerically in the Appendix D. 

15.7 Recovery Steps 

If GLASMeta terminates with an error: 

1) Review error and status messages in the ANC06 file or on stdout to detennine 
source or location of problem. Refer to errors listed in Appendix D for assistance in 
detennining the problem. 

2) Correct the problem 

3) Remove previous output files 

4) Re-run the software 

In case of a problematic error, which cannot be easily diagnosed, debug versions of 
GLAS Meta will be available for test use. This is, however, more of a developer procedure 
than a user procedure. Software users should contact the GSAS Development Team for more 
instructions. 

15.8 Sample GLAS_Meta Control File 

=GLAS_Meta 

# 

# Execution Information 

# 

EXEC_KEY=p3tl 
PGE_VERSION=V2 . 2 
DATE_GENERATED= 1 1 January 2002 
OPERATORS lee 
# 

# Static ANC Files 

# 

# Input ANC07 Files : 00=error, 01=global 

# 

INPUT_FILE=anc07_001_01_0000 . dat 0000000 1000000 
INPUT_FILE=anc07_001_01_0001 . dat 0000000 1000000 
# 

# Input Metadata Templates 

# 

INPUT_FILE=anc45_001_01_0001 . dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0002 . dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0003 . dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0004 . dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0005 . dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0006 . dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0007 . dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0008 . dat 0000000 100000000 
INPUT FILE=anc45 001 01 0009.dat 0000000 100000000 
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INPUT_FILE=anc45_001_01_0010 . dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0011 . dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0012 .dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0013 .dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0014 . dat 0000000 100000000 
INPUT_FILE=anc45_001_01_0015 .dat 0000000 100000000 
# 

# Input gla files 

# 

INPUT_F I LE =GLA0 1_0 0 2_2 2_0 1 0 0 5_2 3 3 2_1_0 1_0 0 0 0 . DAT 0 52000000 1 1 0 
INPUT_FILE=GLA02_002_22_01005_2331_0_01_0000 .DAT 0 52000000 110 
INPUT_FILE=GLA04_002_22_01005_2331_0_01_0006 .DAT 0 52000000 110 
INPUT_FILE=GLA05_002_22_01005_2332_1_01_0000 .DAT 0 52000000 110 
INPUT_F ILE =GLA0 6_0 0 2_2 2_0 1 0 0 5_2 3 3 2_1_0 1_0 0 0 0 . DAT 0 52000000 1 1 0 
INPUT_F ILE =GLA0 7_0 0 2_2 2_0 1 0 0 5_2 3 3 1_0_0 1_0 0 0 0 . DAT 0 52000000 1 1 0 
INPUT_FILE=GLA08_002_22_01005_2331_0_01_0000 .DAT 0 52000000 110 
INPUT_F I LE =GLA0 9_0 0 2_2 2_0 1 0 0 5_2 3 3 1_0_0 1_0 0 0 0. DAT 0 52000000 1 1 0 
INPUT_F ILE =GLA1 0_0 0 2_2 2_0 1 0 0 5_2 3 3 3_0_0 1_0 0 0 0 . DAT 0 52000000 1 1 0 
INPUT_F ILE =GLA1 1_0 0 2_2 2_0 1 0 0 5_2 3 3 1_0_0 1_0 0 03 DAT 0 52000000 1 1 0 
INPUT_F ILE =GLA1 2_0 0 2_2 2_0 1 0 0 5_2 3 2 5_0_0 1_0 0 0 0. DAT 0 52000000 1 1 0 
INPUT_FILE=GLA13_002_22_01005_2325_0_01_0000 .DAT 0 52000000 110 
INPUT_FILE=GLA14_002_22_01005_2325_0_01_0000 .DAT 0 52000000 110 
INPUT_F I LE =GLA1 5_0 0 2_2 2_0 1 0 0 5_2 3 2 5_0_0 1_0 0 0 0. DAT 0 52000000 1 1 0 
# 

# Output ANC Files 

# 

# Output ANC06 

# 

OUTPUT_FILE=anc06_glas_meta . dat 0000000 1000000 

# 

# Output GLA Files 

# 

OUTPUT_FILE=GLA0 1_0 0 2_2 2_0 10 0 5_2 3 3 2_1_0 1_0 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLA0 2_0 0 2_2 2_0 10 0 5_2 3 3 1_0_0 1_0 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLA0 5_0 0 2_2 2_0 10 0 5_2 3 3 2_1_0 1__0 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLA04_0 0 2_2 2_0 10 0 5_2 3 3 1_0_0 1_0 0 06. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLA0 6_0 0 2_2 2_0 10 0 5_2 3 3 2_1_0 1_0 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLA0 7_0 0 2_2 2_0 10 0 5_2 3 3 1_0_0 1_0 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLA0 8_0 0 2_2 2_0 10 0 5_2 3 3 1_0_0 1_0 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLA0 9_0 02_22_0 1 0 05_2 33 1_0_0 1_0 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLAl 0_0 0 2_2 2_0 10 0 5_2 3 3 3_0_0 10 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLAl 1_0 0 2_2 2_0 10 0 5_2 3 3 1_0_0 1_0 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLA12_0 0 2_2 2_0 10 0 5_2 3 2 5_0_0 1_0 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLA13_0 0 2_2 2_0 10 0 5_2 3 2 5_0_0 1_0 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLA14_0 0 2_2 2_0 10 0 5_2 3 2 5_0_0 1_0 0 00. MET 0 52000000 1 1 0 
OUTPUT_FILE=GLAl 5_0 0 2_2 2_0 10 0 5_2 3 2 5_0_0 1_0 0 00. MET 0 52000000 1 1 0 
# 

# End of Control File 

# 
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16.1 Function 

GLASGPS is a Fortran 90 wrapper written around the JPL-supplied RINEX (Receiver Inde- 
pendent Exchange Fonnat) processing software. GLAS GPS reads the APID 1088 GPS data 
and products (via RINEX) and ANC39 ASCII file containing processed GPS information. 
GLAS GPS allows for multi-granule input and output files. 

Note: The functionality of GLAS GPS has been depreciated. UTCSR will process the APID 
1088 files to obtain the GPS data. GLAS GPS will not be used in ISIPS production process- 
ing and is not being maintained. 

16.2 Input Files 

Table 16-1 lists the inputs to GLAS GPS. Files which are specific to GLAS GPS are docu- 
mented in this section. See the appropriate section of this document or the GLAS Data Prod- 
ucts Specifications Volumes for details regarding the those files not specific to GLAS GPS. 


Table 16-1 GLAS GPS Inputs 


File Spec 

Type 

Source 

Short Description 

gla00*_1 088.dat 

Level-0 APID 

EDOS 

GLAS GPS APID file. 

anc07*_CM .dat 

Static Ancillary 

Science Team 

GLAS global constants file. 

Control File 

Control 

ISIPS Operations 

Control file. 


16.2.1 Control File 

The control file fonnat and common elements are documented in Section 5 of this document. 
Elements specific to GLAS GPS are described in this section. 

The control file section delimiter for GLAS GPS is: 

=GLAS_GPS 

Since GLAS GPS has no requirement for execution scenarios, there are no unique keywords 
for the GLAS GPS control file. GLAS GPS will perform all functions based on the presence 
of input and output files within the control file. 

16.3 Output Files 

Table 16-2 lists the outputs created by GLAS GPS. Files which are specific to GLAS GPS 
are documented in this section. See the appropriate section of this document or the GLAS 
Data Products Specifications Volumes for details regarding the files which are not specific to 
GLAS GPS. 
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Table 16-2 GLAS GPS Outputs 



File Spec 

Type 

Destination 

Short Description 

anc39*.dat 

Dynamic Ancillary 

UTCSR 

Text-based output from the 
RINEX processing software. 

anc06*.dat 

Dynamic Ancillary 

ISIPS Operations 

Standard metadata/processing 
log file. 


16.3.1 ANC39 RINEX Output Files 

For more information on RINEX - See the document “RINEX: The Receiver Independent 
Exchange Fonnat Version 2”. 


16.4 Processing and Reprocessing Scenarios 

GLASGPS supports only a full-processing scenario. All processing is based on the presence 
of input and output files within the control file. 

Additionally, time-selected processing is not supported. The start and stop times on the 
INPUT FILE and OUTPUT FILE control file entries are ignored for processing. 

16.5 Startup and Termination 

This is an overview of the steps necessary to run GLAS GPS. Specific operational procedures 
will be provided in the ISIPS Operational Procedures Manual. 

16.5.1 Setup a Runtime Directory 

The suggested method of running GLAS GPS is to create a temporary directory and link all 
necessary files into it. The SDMS will create a temporary directory and link all necessary files 
into it. For example, to setup a GLAS GPS run, one would perform the following steps (Des- 
ignate TEMP DIR as the temporary directory and DATA DIR as the location in which input 
data for this job has been staged): 

mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/GLAS_GPS . 

In -s $ GLAS_HOME / lib/* . 

In -s $GLAS_HOME/data/anc07* . dat . 

In -s $DATA_DIR/* .dat . 

16.5.2 Create a Control File 

GLAS GPS is designed to take the name of a control file as a command-line argument. The 
suggested method of creating a control file is by copying a template from the 
$GLAS_HOME/data directory and modifying it with desired input/output filenames and data 
processing options. 

cp $GLAS_HOME/data/cf_GLAS_GPS . ctl . / control_file_name 
vi . / control_file_name 
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16.5.3 Run the PGE 

Error and status messages will be displayed on screen (stdout) and recorded in the ANC06 
fde. 


. /GLAS_GPS control_f ile_name 

16.5.4 Run-Time Statistics 

Since GLASGPS will not be used in the production environment, no runtime statistics have 
been recorded. 

16.5.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. The log / 
metadata file (ANGOLA) must be examined to determine runtime success. Additionally, the 
process will return a result code to the operating system which may be used to programatically 
detennine success or failure (0=success, 3=fatal error). 

16.6 Error and Warning Messages 

All GSAS error and warning messages are listed numerically in the Appendix D. 

16.7 Recovery Steps 

If GLAS GPS terminates with an error: 

1) Review error and status messages in the ANC06 file or on stdout to detennine 
source or location of problem. Refer to errors listed in Appendix D for assistance in 
detennining the problem. 

2) Conect the problem 

3) Remove previous output fdes 

4) Re-run the software 

In case of a problematic error, which cannot be easily diagnosed, debug versions of 
GLAS GPS will be available for test use. This is, however, more of a developer procedure 
than a user procedure. Software users should contact the GSAS Development Team for more 
instructions. 

16.8 Sample GLAS_GPS Control File 

=GLAS_GPS 

# 

# Execution Information 

# 

EXEC_KEY=p3tl 
PGE_VERSION=V2 . 2 
DATE_GENERATED= 1 1 January 2002 
OPERATORS lee 
# 

# Static ANC Files 

# 


March 2013 


Page 16-3 


Version 7.0 



The GLAS Science Algorithm Software (GSAS) User’s Guide 


GLAS GPS 


# Input ANC07 Files : 00=error, 01=global 

# 

INPUT_FILE=anc07_001_01_00 . dat 0000000 1000000 
INPUT_FILE=anc07_001_01_01 . dat 0000000 1000000 
# 

# Input GPS APID 

# 

INPUT_FILE=glaOO_008_20020406_010000_01_1088 . dat 51861600 51883201 

# 

# Output ANC Files 

# 

OUTPUT_FILE=anc06_GLAS_GPS .dat 0000000 1000000 

OUTPUT_FILE=anc39_008_2 0020406_010000_01_1088 . dat 51861600 51883201 

# 

# End of Control File 

# 
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GLAS APID 


17.1 Function 

GLASAPID is a modified form of GLASReader which will read GLAOO APID files and 
create spreadsheet-friendly, column-based text files. Since GLAS APID does not attempt to 
time-align the APIDS, (unlike GLAS Reader) the ANC29 file is not required (but supported). 
GLAS_APID currently only processes ANC29, ANC32, and APID 19 but its functionality 
will be expanded to include most APIDs of interest. 

Like GLAS Reader, GLAS APID has a rudimentary interface which will let the user specify 
input files from the command line. As with control file specifications, start and stop times are 
required along with the filename. The interface is invoked when running GLAS APID with- 
out a control file argument. 

GLASAPID perfonns no processing, but permits specification of what type of data should be 
written to the text file. GLAS APID also supports input/output time selection. 

Note: GLAS APID is not intended for production use. 

17.2 Input Files 

Table 17-1 lists the inputs to GLAS APID. Files which are specific to GLAS APID are docu- 
mented in this section. See the appropriate section of this document or the GLAS Data Prod- 
ucts Specifications Volumes for details regarding the those files not specific to GLAS APID. 


Table 17-1 GLAS APID Inputs 


File Spec 

Type 

Source 

Short Description 

anc29*.dat 

Dynamic Ancillary 

GLAS_L0proc 

Index file correlating APID 
times. 

anc32*.dat 

Dynamic Ancillary 

GLAS_L0proc 

Frequency board to GPS time 
correlation file. 

gla00*_1 9.dat 

Level-0 APID 

EDOS 

GLAS AncSci APID file. 

anc07*_0000.dat 

Static Ancillary 

Science Team 

GLAS error file. 

anc07*_0001 .dat 

Static Ancillary 

Science Team 

GLAS global constants file. 

Control File 

Control 

ISIPS Operations 

Control file. 


17.2.1 Control File 

The control file fonnat and common elements are documented in Section 5 of this document. 
Elements specific to GLAS APID are described in this section. 

The control file section delimiter for GLAS APID is: 
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=GLAS_APID 

Where appropriate, GLASAPID can output the first element or all elements of pre-record 
data to the output file. The default is to output only the first array element. To designate that 
full-rate output should be created, use the flag defined in Table 17-2. 


Table 17-2 GLAS APID Control Flag 


Flag 

Significance 

APID_RATE=FULLRATE 

Indicates that GLAS_APID should write full-rate array 
values. 


17.3 Output Files 

GLAS APID requires no OUTPUT FILE specifications in the control file. GLAS APID will 
create one or more output files for each type of input file requested. GLAS APID will append 
extensions onto the base filename to create output files. Time selection for the output files is 
based on the time specified with the input files. 

Table 17-3 lists the outputs created by GLAS APID. Files which are specific to GLAS APID 
are documented in this section. See the appropriate section of this document or the GLAS 
Data Products Specifications Volumes for details regarding the files which are not specific to 
GLAS APID. 


Table 17-3 GLAS APID Outputs 


File Spec 

Type 

Destination 

Short Description 

anc29*.dat.txt 

text 

Science Team 

anc29 data in text format. 

anc32*.dat.txt 

text 

Science Team 

anc32 data in text format. 

gla00*_1 9.dat_time.txt 

text 

Science Team 

time-related parameters from apid 1 9 in text 
format. 

gla00*_1 9 -dat_ad.txt 

text 

Science Team 

AD-related parameters from apid 1 9 in text 
format. 

gla00*_1 9.dat_pc.txt 

text 

Science Team 

PC-related parameters from apid 19 in text 
format. 

gla00*_1 9.dat_cd.txt 

text 

Science Team 

CD-related parameters from apid 19 in text 
format. 

gla00*_1 9.dat_gps.txt 

text 

Science Team 

GPS-related parameters from apid 1 9 in text 
format. 

gla00*_1 9.dat_ct.txt 

text 

Science Team 

CT-related parameters from apid 19 in text 
format. 
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17.3.1 APID19 Text Output Files 

One of the ways to make the text files more spreadsheet-friendly is to make the number of col- 
umns in the output file manageable. Therefore, the APID 19 text output is broken up into mul- 
tiple text files grouped by related parameters. 

17.4 Processing and Reprocessing Scenarios 

GLASAPID supports only a full-processing scenario. All processing is based on the pres- 
ence of input and output files within the control file. 

Time-selected processing is supported. The start and stop times on the INPUTFILE and 
OUTPUTFILE control file entries delimit the range of data output. 


17.5 Startup and Termination 


This is an overview of the steps necessary to run GLAS APID. 

17.5.1 Setup a Runtime Directory 

The suggested method of running GLAS APID is to create a temporary directory and link all 
necessary files into it. For example, to setup a GLAS APID run, one would perfonn the fol- 
lowing steps (Designate TEMP DIR as the temporary directory and DATA DIR as the loca- 
tion in which input data for this job has been staged): 


mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/GLAS_APID . 

In -s $GLAS_HOME/lib/* . 

In -s $GLAS_HOME/data/anc07* .dat . 
In -s $DATA_DIR/* .dat . 


17.5.2 Create a Control File 


GLAS APID is designed to take the name of a control file as a command-line argument. The 
suggested method of creating a control file is by copying a template from the 
$GLAS_HOME/data directory and modifying it with desired input/output filenames and data 
processing options. 

cp $GLAS_HOME/data/cf_GLAS_APID . ctl . / control_file_name 
vi . / control_file_name 

17.5.3 Run the PGE 


Error and status messages will be displayed on screen (stdout) and recorded in the ANC06 
file. 


. /GLAS_APID control_f ile_name 

17.5.4 Run-Time Statistics 

Since GLAS APID will not be used in the production environment, no runtime statistics have 
been recorded. 
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17.5.5 Termination 

The process will terminate automatically upon reaching the end of all input data. The log / 
metadata file (ANC06*) must be examined to determine runtime success. Additionally, the 
process will return a result code to the operating system which may be used to programatically 
detennine success or failure (0=success, 3=fatal error). 

17.6 Error and Warning Messages 

All GSAS error and warning messages are listed numerically in the Appendix D. 

17.7 Recovery Steps 

If GLASAPID tenninates with an error: 

1) Review error and status messages in the ANC06 file or on stdout to detennine 
source or location of problem. Refer to errors listed in Appendix D for assistance in 
detennining the problem. 

2) Conect the problem 

3) Remove previous output files 

4) Re-run the software 

In case of a problematic error, which cannot be easily diagnosed, debug versions of 
GLAS APID will be available for test use. This is, however, more of a developer procedure 
than a user procedure. Software users should contact the GSAS Development Team for more 
instructions. 

17.8 Sample GLAS_APID Control File 

This control file reads and writes 100 seconds of ANC29, ANC32, and GLA00 APID 19. 

# 

# This is the control file for the GLAS_APID. 

# 

# Execution Information 

# 

=GLAS_APID 

EXEC_KEY=p3tla 

DATE_GENERATED= 0 8 August 2 0 01 
OPERATORS lee 
PGE_VERSION=2 .2 
# 

# Dynamic ANC Files 

# 

# ANC29 and ANC32 files 

# 

INPUT_FILE=anc29_002_20000101_000000_01_00 . dat 0 100 
INPUT_FILE=anc32_002_20000101_000000_01_00 . dat 0 100 
# 

# GLA00 files 

# 

INPUT_FILE=glaOO_002_20000101_000000_01_19 . dat 0 100 
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# 

# Execution Control 

# 

READER_OPTION=Algorithm 

# 

# End of Control File 

# 
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Section 18 

GLAS Tick 


18.1 Function 

GLAS_Tick reads ANC09, ANC32 and (optionally) GLA03 input files to create ANC50_00 
and ANC50_01 output files. The ANC50_00 contains merged ANC09/ANC32 information 
which is written at a GPS update event. The ANC50 01 contains 6 hour statistics for oscilla- 
tor and engineering data. GLASTick is a full-fledged PGE and allows for multiple-file/multi- 
granule input and output files. Please reference the “Construction of the Lookup Table of 
GLAS Clock Oscillator Frequencies” memo by C. Field, X. Sun, and D. Hancock for require- 
ments specifications. 

18.2 Input Files 

Table 18-1 lists the inputs to GLAS Tick. Files which are specific to GLAS Tick are docu- 
mented in this section. See the appropriate section of this document or the GLAS Data Prod- 
ucts Specifications Volumes for details regarding the those files not specific to GLAS Tick. 


Table 18-1 GLAS Tick Inputs 


File Spec 

Type 

Source 

Short Description 

gla03.dat 

GLAS Products 

GSAS 

GLAS ENG product files. 

anc09*.dat 

Dynamic Ancillary 

UTexas 

Precision Attitude file. 

anc25*.dat 

Dynamic Ancillary 

Science Team 

GPS/UTC conversion file. 

anc32*.dat 

Dynamic Ancillary 

Science Team 

GPS time correction file. 

anc33*.dat 

Dynamic Ancillary 

Science Team 

UTC time conversion file. 

anc07*_0000.dat 

Static Ancillary 

Science Team 

GLAS error constants file. 

anc07*_0001 dat 

Static Ancillary 

Science Team 

GLAS global constants file. 

anc07*_0005.dat 

Static Ancillary 

Science Team 

GLAS L1A constants file. 

Control File 

Control 

ISIPS Operations 

Control file. 


18.2.1 Control File 

The control file fonnat and common elements are documented in Section 5 of this document. 
Elements specific to GLAS Tick are described in this section. 

The control file section delimiter for GLAS Tick is: 

=GLAS_Tick 

As a full-fledged PGE, control file sanity checking is provided. The following conditions are 
checked and the PGE will error-out if a condition is violated: 
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• There must be exactly 1 anc25 input file. 

• There must be exactly 1 anc33 input file. 

• There must be anc07 input files. 

• There must be at least one ANC32 input file. 

• There must be at least one ANC09 input file. 

• There must be at least one ANC50_0000 and ANC50_0001 output file. 

• There must be the same number of ANC50_0000 and ANC50_0001 output files. 

Since GLASTick has no requirement for execution scenarios, there are no unique keywords 
for the GLAS Tick control file. GLAS Tick will perform all functions based on the presence 
of input and output files within the control file. 

Time controls on input/output files specification lines are enforced. 

18.3 Output Files 

Table 18-2 lists the outputs created by GLAS Tick. Files which are specific to GLAS Tick 
are documented in this section. See the appropriate section of this document or the GLAS 
Data Products Specifications Volumes for details regarding the files which are not specific to 
GLAS Tick. 


Table 18-2 GLAS Tick Outputs 


File Spec 

Type 

Destination 

Short Description 

anc50*_0000.txt 

Text file 

ISF/Science Team 

Merged ANC09/ANC32 file. 

anc50*_0001 .txt 

Text file 

ISF/Science Team 

Frequency trend file. 

anc06*.txt 

Dynamic Ancillary 

ISIPS Operations 

Standard metadata/processing 
log file. 


18.3.1 anc50_0000.txt File 

The anc50_0000 file is a merged ANC09/ANC32 file. The file contains multiple lines of tab- 
separated fields with descriptive headers. The files are designed to import cleanly into MS 
Excel. A line is written each time a GPS update occurs (once per 10 seconds). For parameters 
whose rate is greater than once per second, only the first value is written. Parameters are writ- 
ten in the following format (where A1 represents a TAB character): 

116, 2 (Al, F20 .4) ,A1, F20 . 9, 8 (Al, F20 .4) ,2 (Al, 116) , 7 (Al, F20 .4) ,A1,A3 

18.3.2 anc50_0001.txt Files 

The anc50_0001 file contains statistics computed from parameters in the ANC09/GLA03 
files. The file contains multiple lines of tab-separated fields with descriptive headers. The files 
is designed to import cleanly into MS Excel. Each line contains statistics for (nominally) 6 
hours of data. When computing min/mean/max statistics for parameters whose rate is greater 
than one per second, all values are used in the computation. Additionally, those parameters 


Version 7.0 


Page 18-2 


March 2013 






GLAS Tick 


The GLAS Science Algorithm Software (GSAS) User’s Guide 


which are component-sensitive use values consistent with the active instrument. Depending 
upon the presence of GLA03 input (see next section) parameters are written in one of the two 
following formats (where A1 represents a TAB character): 

(with GLA03 inputs) 

2 (I16,A1) , 6 (F20 ,4,A1) , 16, 5 (Al, F20 . 14) , 33 (Al, F20 .4) 

(without GLA03 inputs) 

2 (I16,A1) , 6 (F20 .4,A1) , 16, 5 (Al, F20 . 14) 

18.4 Processing and Reprocessing Scenarios 

GLASTick supports two different processing scenarios, dependent on the presence of 
GLA03 input fdes. Simply, if GLA03 input fdes are present, GLA03 statistics are computed 
and written. If GLA03 inputs are not present, no GLA03 statistics are computed or written. 
These scenarios are based entirely on the presence of GLA03 input files within the control 
fde. 


18.5 Startup and Termination 


This is an overview of the steps necessary to run GLAS Tick. 

18.5.1 Setup a Runtime Directory 

The suggested method of running GLAS Tick is to create a temporary directory and link all 
necessary files into it. The SDMS will create a temporary directory and link all necessary files 
into it. For example, to setup a GLAS Tick run, one would perform the following steps (Des- 
ignate TEMPDIR as the temporary directory and DATA DIR as the location in which input 
data for this job has been staged): 


mkdir $TEMP_DIR 
cd $TEMP_DIR 

In -s $GLAS_HOME/bin/GLAS_Tick . 
In -s $GLAS_HOME/lib/* . 

In -s $GLAS_HOME/data/anc07* .dat 
In -s $GLAS_HOME/data/anc25* .dat 
In -s $GLAS_HOME/data/anc33* .dat 
In -s $DATA_DIR/* .dat . 


18.5.2 Create a Control File 


GLAS Tick is designed to take the name of a control file as a command-line argument. The 
suggested method of creating a control file is by copying a template from the 
$GLAS_HOME/data directory and modifying it with desired input/output filenames and data 
processing options. 

cp $GLAS_HOME/data/cf_GLAS_Tick . ctl . / control_file_name 
vi . / control_file_name 
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18.5.3 Run the PGE 

Error and status messages will be displayed on screen (stdout) and recorded in the ANC06 
fde. 


./GLAS_Tick control_f ile_name 

18.5.4 Run-Time Statistics 

GLASTick has minimal processing requirements since it only parses the product header 
records. 

18.5.5 Termination 

The process will tenninate automatically upon reaching the end of all input data. The log / 
metadata file (ANC06*) must be examined to determine runtime success. Additionally, the 
process will return a result code to the operating system which may be used to programatically 
detennine success or failure (0=success, 3=fatal error). 

18.6 Error and Warning Messages 

All GSAS error and warning messages are listed numerically in the Appendix D. 

18.7 Recovery Steps 

If GLAS Tick terminates with an error: 

1) Review error and status messages in the ANC06 file or on stdout to detennine 
source or location of problem. Refer to errors listed in Appendix D for assistance in 
detennining the problem. 

2) Conect the problem 

3) Remove previous output files 

4) Re-run the software 

In case of a problematic error, which cannot be easily diagnosed, debug versions of 
GLAS Tick will be available for test use. This is, however, more of a developer procedure 
than a user procedure. Software users should contact the GSAS Development Team for more 
instructions. 

18.8 Sample GLAS_Tick Control File 

=GLAS_Tick 

# Start of Control File 

# 

# This is an control file automatically generated by 

# create_tick_ctl . sh . 

# 

# Execution Information 

# 

EXEC_KEY=auto 

DATE_GENERATED=Thu Jan 8 18:25:19 EST 2004 
OPERATOR=ACC TEST 
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PGE_VERSION=ACC_TEST 

# 

# Input Static ANC Files 

# 

# Input ANC 07 

# 

INPUT_FILE=anc07_013_01_0000 . dat 01 110 

INPUT_FILE=anc07_013_01_0001 . dat 01 110 

INPUT_FILE=anc07_013_01_0005 .dat 01 110 

INPUT_FILE=anc2 5_0 0 1_2 0 0 2 12 13_0 0 0 0 0 0_0 1_0 0 0 0. dat 01 110 

INPUT_FILE=ANC33_001_20031223_193523_01_0000 .DAT 0 1 
# 

# Input/Output Files 

# 

INPUT_FILE=ANC32_0 12_2 0 03 0 925_18 0 0 0 0_01_0 0 01. DAT 0 1 
INPUT_FILE=ANC32_012_2 0 03 0 926_00 0 0 0 0_01_0 0 01. DAT 0 1 
INPUT_FILE=ANC32_0 12_2 0 03 0 926_0 6 0 0 0 0_01_0 0 01. DAT 0 1 
INPUT_FILE=ANC32_0 12_2 0 03 0 926_12 0 0 0 0_01_0 0 01. DAT 0 1 
INPUT_FILE=ANC32_0 12_2 0 03 0 926_18 0 0 0 0_02_0 0 01. DAT 0 1 
INPUT_FILE=ANC32_0 12_2 0 03 0 927_0 0 0 0 0 0_02_0 0 01. DAT 0 1 

INPUT_F ILE =GLA0 3_0 1 3_1 102_028_009 1_0_0 1_0 0 01. DAT 117799207 . 0 117810806 . 0 
INPUT_FILE=GLA03_013_1102_028_0093_0_01_0001 .DAT 117810807 . 0 117822407 . 0 
INPUT_F ILE =GLA0 3_0 1 3_1 102_028_009 5_0_0 1_0 0 01. DAT 117822408 . 0 117834006 . 0 
INPUT_FILE=GLA03_013_1102_028_0097_0_01_0001 .DAT 117834007 . 0 117845607 . 0 
INPUT_FILE=GLA03_013_1102_028_0099_0_01_0001 .DAT 117845608 . 0 117857206 . 0 
INPUT_FILE=GLA03_013_1102_028_0101_0_01_0001 .DAT 117857207 . 0 117868815 . 0 
INPUT_F ILE =GLA0 3_0 1 3_1 102_028_01 0 3_0_0 1_0 0 01. DAT 117868816 . 0 117880414 . 0 
INPUT_FILE=GLA03_013_1102_028_0105_0_01_0001 .DAT 117880415 . 0 117892014 . 0 
INPUT FILE=GLA03 013 1102 028 0107 0 01 0001.DAT 117892015.0 117903615.0 


INPUT_FILE=ANCO 9_0 05_2 0 03 0 925_23 594 7_01_0 0 01. DAT 117806400.0 117892800.0 1 1 0 
OUTPUT_FILE=ANC50_0 05_2 0 03 0 92 5_2 3 5 94 7_0 10 0 00. txt 117806400.0 117892800.0 1 1 0 
OUTPUT_FILE=ANC50_0 05_2 0 03 0 92 5_2 3 5 94 7_0 10 0 01. txt 117806400.0 117892800.0 1 1 0 
OUTPUT FILE=ANC0 6 tick 005 20030925 235947 01 0001.DAT 110 


# 

# Execution Control 

# 

# (none) 

# 

# End of GLAS_Tick Section 

# 
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Section 19 

QABrowse 


19.1 Introduction 

Program Name: QABrowse 

Language: Interactive Data Language (IDL) 

Function: Read quality assurance files for the data products and output image files with plots 
of the data that can be examined with a web browser. 

19.2 Overview of Purpose and Functions 

Purpose: Generate images that can be browsed over the web to let users determine whether 
they want to look at the data in the granules. 

Function: Read QAP files and output image files. 

19.3 Startup and Termination 

To run the program: 

1) Change to a runtime directory 

2) Generate the control file. 

3) The following three directories should be in your path: 

/ <GLAS_HOME>/idl/ qa_browse/browse 
/ <GLAS_HOME>/idl/ qa_browse/read 
/ <GLAS_HOME>/idl/ qa_browse/util 

where GLASHOME is as defined in previous sections of this document. These can be added 
to your IDL path with the command 

IDL> !path = ' /<G L A S_ H O VI E>/i d l/q a_b ro wse/b r o wse : ' $ 

+ 7<GLAS_HOME>/idl/qa_browse/read:' $ 

+7<GLAS_HOME>/idl/qa_browse/util:’ + !path 

issued after you enter IDL and BEFORE you run the program. Here you need to substitute the 
value of GLAS HOME in place of each <GLAS_HOME> since IDL does not know what this 
environment variable is. For example, if 

GLASHOME = /data/myworkingdir, 

the actual statement would be 

IDL> !path = 7data/myworkingdir/idl/qa_browse/browse:' $ 


March 2013 


Page 19-1 


Version 7.0 



The GLAS Science Algorithm Software (GSAS) User’s Guide 


QABrowse 


+ '/data/myworkingdir/idl/qa browse/read:' $ 

+ 7data/myworkingdir/idI/qa_browse/util:" +!path 

4) Either 

a. [i] Enter IDL and at the IDL prompt type 

IDL> qabrowse, controlFileName 
[ii] Exit from IDL. 

OR 

b. at the shell prompt or in a script, enter 

$> runbrowse controlFileName 

5. Move the output files (if you generated any) wherever they belong, if necessary. 

19.4 Functions and Their Operation 

The main functions of this program are: 

Read the control file 
Read the QAP files 
Generate QA browse images. 

19.5 Input Arguments 

19.5.1 Control File 

This program requires the name of a control file as a command-line argument. The program 
reads input from the control file to determine control parameters. A sample control file is pro- 
vided in the code directory (sample.txt) and is shown below. 

19.6 Input Files 

19.6.1 Control File 

The program reads through the file until it finds a line containing 
=QABROWSE 

and nothing else. At that point, it reads and interprets all lines until it finds another line with 
an = sign in column 1, at which point the program stops reading, closes the control file, and 
begins processing. 

Only lines of the form 

KEY=Value 

are evaluated, and they may be in any order. 
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The following KEY= Value pairs have meaning. Except for INPUT_FILE, only the last occur- 
rence of each one is used. 


Table 19-1 Description of Control File Contents 


ENVIRONMENT=Value 

OPTIONAL. Value = ISIPS or SCF, depending on where the 
product files were generated. The SCF version generates png 
files with different file names, and is not as strict with respect 
to the expected lat/lon range of the data. SCF will work for the 
ISIPS files but the plots may not have nice limits in some 
cases. 

Example: 

ENVIRONMENT=ISIPS 
Default: ISIPS 

VERSION=Value 

OPTIONAL. 

As of QAP Version 4.4 (GSAS version 4.3), the version is read 
from the QAP file header. An override option is available -- 
see FORCE_VERSION. For previous versions of the pro- 
gram, use the following: 

VERSION = 1 is obsolete and should not be used. 

VERSION = 2 is for files produced by version 3.0 or earlier of 
the GSAS software (MOSS 10 testing). 

VERSION = 3 is for files produced after version 3.0 of the 
GSAS software. It differs from VERSION=2 in that GLA06 and 
12-15 QAP files were written as one record per along-track 
record, followed by a separator record consisting of one 
along-track record filled with invalids, followed by one sum- 
mary record written as a single record. The along-track 
records contain averages of the trap and tide corrections, and 
the summary record contains histograms of these quantities 
plus number of elements in each histogram and lower limit of 
the first histogram bin and upper limit of the last histogram bin. 
VERSION=3.7: Added saturation flags to QAP05 
VERSION=3.8: Change length of energy histograms in 
QAP02 

VERSION=4 differs from VERSION=3 in that global summa- 
ries of the range parameters were added to the summary 
records in the elevation qap files (GLA06,12-15). 
VERSION=4.1 : Metadata changes to QAP6 and 12-15 
VERSION=4.2: Added images to QAP7-11 

FORCEVERSION 

OPTIONAL. Logical Flag 

If set, use the VERSION specified by the VERSION keyword. 
Ignore any version that may be in the QAP file header. 
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Table 19-1 Description of Control File Contents (Continued) 


OUTPUT_FORMAT=Value 

OPTIONAL. Value should be a string. This parameter speci- 
fies the format for the output plots. 

Allowed values:PNG (file output in png format) 

X (screen plots on an x-window system) 
PS (file output in Postscript format) 

HDF (Hierarchical Data Format) 

Example: 

OUTPUT FORMAT=PNG 
Default:HDF 

OUTPUT_DIRECTORY=Value 

OPTIONAL. Value is a string containing the name of the 
directory in which the output files (if any) are to be stored. If 
the output directory line is present and the value does not end 
in a / (on Unix systems) or\ (on Windows systems), one is 
added. 

Example: 

OUTPUT_DIRECTORY=/home/jack/ 

Default: current directory. 

INPUT_FILE=Value 

REQUIRED. Value should be a string containing the name of 
the QAP file to be processed. It is assumed that the file name 
is of the form "path/qapxx..." (without the quotes), where xx is 
a 2-digit number between 01 and 15. "path/" is the full path to 
the file, and may be left off if the file is in the working directory, 
"path" and "qap" may be any mix of upper and lower case 
characters but must correspond exactly to the actual path and 
file names. INPUTFILE may appear any number of times, in 
which case all QAP files listed are processed. At least one 
INPUT FILE is required. If there are no lines of this form, the 
program will assume there is no data to be processed and will 
quietly stop. 

Example: 

INPUT FILE=/XOVER/disk4/jack/ 
GLA06_009_1102_004_0065_3_01_0001 .qap 

CATCHCANCEL 

OPTIONAL. 

This is a debug flag designed to turn off the CATCH error han- 
dling function to help trap errors. It should NOT be used in 
production processing. 

CATCHCANCEL=0. Default. CATCH error handling is in 
effect. 

CATCHCANCEL=1 . CATCH error handling is turned off. Pro- 
gram will issue an error message and STOP at the point 
where the error occurs. 
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Table 19-1 Description of Control File Contents (Continued) 


QUIET 

OPTIONAL. 

This is a debug flag and should not be used in production pro- 
cessing. QUIET is used to set IQUIET (see IDL documenta- 
tion for values). 

EXCEPT 

OPTIONAL. 

This is a debug flag and should not be used in production pro- 
cessing. EXCEPT is used to set IEXCEPT (see IDL documen- 
tation for values). 
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Table 19-2 Sample Control File 

= QABROWSE 
VERSION=3 . 6 
ENVIRONMENT=GSAS 

# First QAP file to be processed 

INPUT_FILE = /home/ j ack/ GLA03_0 03_2 0 03 0 92 5_164 54 5_0 1_0 0 0 0. QAP 

# A second QAP file to be processed 

INPUT_FILE=/home/ j ack/ glas/ 
GLA06_012_20031005_180404_01_0000 . QAP 

INPUT_FILE=/home/jack/anc07_001_01_0005 . dat 
OUTPUT_DIRECTORY=/home/ j ack 
OUTPUT_FORMAT=png 
= END 

19.6.2 QAP File 

One or more QAP files are required as input. 

19.6.3 ANC File 

None required. 

19.7 Output 

19.7.1 GLA01 

For GLA01, the program generates four plots for each input QAP file. 

Plot 1 : global summary 

Plots 2-3: bars showing min, max, average, std dev, and number of measurements for a variety 
of parameters 

Plot 4: time histories 

19.7.2 GLA02 

For GLA02, the program generates three plots for each input QAP file. 

Plot 1 : summary information, groundtrack map of integrated return 
Plot 2: 532 nm data 


Version 7.0 


Page 19-6 


March 2013 




QABrowse 


The GLAS Science Algorithm Software (GSAS) User’s Guide 


Plot 3: 1064 nm data 

19.7.3 GLA03 

For GLA03, the program generates a global summary Plot with a list of % missing data, fol- 
lowed by a list of out-of-bound parameters and how many times each was out of bounds. This 
list may extend to several pages. 

The remaining pages contain bar plots showing min/max/average/std dev/number of points 
for a variety of parameters. 

19.7.4 GLA04 

For GLA04, the program generates eight plots. Plots 1-4 are global summary data and plots 5- 
8 contain along-track averages. 

Plot 1 : summary LPA and LRS images and Granule statistics. 

Plots 2 and 3: granule statistics for a number of LRS, BST, and 1ST parameters. 

Plot 4: histograms of a number of BST, 1ST, and LRS parameters. 

Plot 5: along-track averages of LPA and Gyro parameters. 

Plot 6: along-track averages of LRS parameters. 

Plot 7: along-track averages of Solar array, Attitude, and BST parameters. 

Plot 8: along-track averages of several 1ST parameters. 

19.7.5 GLA05 

For GLA05, the program generates either 13 or 16 plots for each input QAP file. Fewer Plots 
are generated for equatorial regions because these do not have any ice sheet regions. There are 
three different types of plots: 

1) Global summary data. Only one of these per input QAP file. 

2) Histograms. One Plot for each surface type, and one for all surface types combined. 

3) Groundtrack maps of along-track data. Two Plots for each surface type, and one for 
all surface types combined. 

19.7.6 GLA06 

For GLA06, the program generates two to four plots for each input QAP file. Fewer Plots are 
generated for earlier versions of GLA06 QAP files. 

Plot 1 : summary data, histograms, and groundtrack maps of along-track data 
Plot 2 and 3: groundtrack maps of along-track data 

Plot 4: bars showing min, max, average, std dev, and number of measurements for the range 
adjustment parameters. 
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19.7.7 GLA07 

For GLA07, the program generates one global summary plot and one image (two per plot) for 
every orbit for 532 mn and for 1064-nm data. There are a minimum of 3 plots — the summary 
and one each for 532 and 1064. 

19.7.8 GLA08 

For GLA08, the program generates one global summary plot. 

19.7.9 GLA09 

For GLA09, the program generates one global summary plot. 

19.7.10 GLA10 

For GLA10, the program generates at least four plots: 

Plot 1 : Global summary and along-track maps of %valid cloud backscatter and aerosol back- 
scatter. 

Plot 2: Along-track parameters. 

Plots 3-N: Images of the vertical distribution of cloud extinction. One orbit per image, two 
images per plot. 

Plots N+l on: Images of the vertical distribution of aerosol extinction. One orbit per image, 
two images per plot. 

19.7.11 GLA011 

For GLA1 1, the program generates two plots: 

Plot 1: Global summary and along-track parameters. 

Plot 2: Along-track parameters. 

19.7.12 GLA12 

For GLA12, the program generates two to four plots for each input QAP file. Fewer Plots are 
generated for earlier versions of GLA12 QAP files. 

Plot 1 : summary data, histograms, and groundtrack maps of along-track data 
Plots 2 and 3: groundtrack maps of along-track data 

Plot 4: bars showing min, max, average, std dev, and number of measurements for the range 
adjustment parameters. 

19.7.13 GLA13 

For GLA13, the program generates two to four plots for each input QAP file. Fewer Plots are 
generated for earlier versions of GLA13 QAP files. 

Plot 1 : summary data, histograms, and groundtrack maps of along-track data 
Plots 2 and 3: groundtrack maps of along-track data 
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Plot 4: bars showing min, max, average, std dev, and number of measurements for the range 
adjustment parameters. 

19.7.14 GLA14 

For GLA14, the program generates two to four plots for each input QAP file. Fewer Plots are 
generated for earlier versions of GLAM QAP files. 

Plot 1 : summary data, histograms, and groundtrack maps of along-track data 
Plots 2 and 3: groundtrack maps of along-track data 

Plot 4: bars showing min, max, average, std dev, and number of measurements for the range 
adjustment parameters. 

19.7.15 GLA015 

For GLAM, the program generates two to four plots for each input QAP file. Fewer Plots are 
generated for earlier versions of GLAM QAP files. 

Plot 1 : summary data, histograms, and groundtrack maps of along-track data 
Plots 2 and 3: groundtrack maps of along-track data 

Plot 4: bars showing min, max, average, std dev, and number of measurements for the range 
adjustment parameters. 

19.8 Error and Warning Messages 

All warning and error messages generated by the program are self-explanatory. Any error 
messages generated by IDL should be reported except for floating underflows. These error 
messages are generated by the IDL internals and there does not appear to be any way to avoid 
getting them at least some of the time. 

If the program generates the output plots successfully, IDL exits with exit code QA NoError 

= 0 . 

If the program ends without generating all plots, IDL exits with a nonzero exit code. The exit 
codes are defined in file util/qa exitcodes.pro. 

19.9 Recovery Steps 

Exit IDL, correct the error in the control file, and start over. 
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Section 20 

QAPG 


20.1 Introduction 

Program NameiQAPG, from QAP Generator 
Language: Fortran 90 

Function: Read product files (granules) and generate QAP files 

20.2 Overview of Purpose and Functions 

Purpose: Read product files (granules) and generate QAP files 
Function: Read product files (granules) and generate QAP files 

20.3 Startup and Termination 

To run the program: 

1) Change to a runtime directory 

2) Generate a control file. 

3) At the shell prompt or in a script, enter 

$> qapg controIFileName 

20.4 Functions and Their Operation 

The main functions of this program are: 

Read the control file 
- Read the product file 
Generate QAP file 

20.5 Input Arguments 

20.5.1 Control File 

This program requires the name of a control file as a command-line argument. The program 
reads input from the control file to determine control parameters. A sample control file is pro- 
vided in the code directory (sample.txt) and is shown below. 

20.6 Input Files 

20.6.1 Control File 

The program reads through the file until it finds a line containing 
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=PROD_VER 

and nothing else. The = should be in column 1 and there should be no space between it and the 
P. At that point, the program reads and interprets all lines until it finds another line with an = 
sign in column 1, at which point the program stops reading, closes the control file, and begins 
processing. 

Only lines of the form 

KEY=Value 

are evaluated, and they may be in any order. 

20.6.2 Product File(s) 

One (or six for GLA04) product file is required as input. 

20.6.3 ANC Files 

ANC07 0000, 0003, 0004, and 0006 are required. 

20.7 Output 

QAPG generates one QAP file each time it is run successfully. 

20.8 Error and Warning Messages 

There are some of these in the portion of the code written by Kristine Barbieri. 

20.9 Recovery Steps 
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Table 20-1 Description of Control File Contents 

INPUT_FILE=Value There are two types of input files. 

Type 1: REQUIRED. Value should be a string containing the 
name of the product file to be processed. 

In general, it is assumed that the file name is of the form 
"GLAxx..." (without the quotes), where xx is a 2-digit number 
between 01 and 15, and "GLA" may be any mix of upper and 
lower case characters but must correspond exactly to the actual 
path and file names. GLA04 file names have special require- 
ments. 

For GLA01 - GLA03 and GLA05 - GLA 15, INPUTFILE may 
appear only once. 

For GLA04, INPUT FILE must appear six times, and the name 
must be of the form 

GLAxx... OOOY.zzz, 

where Y = 1,2, 3, 4, 5, and 6. The rest of the file name must fol- 
low the rules for the other products. 

Y designates the type of GLA04 product file, as follows: 

1: LPA 

2: LRS 

3: Gyro 

4: 1ST 

5: BST 

6: Spacecraft 

Example: 

INPUT_FILE= 

GLA01_012_1102_002_0013_4_01_0001.DAT 

Type 2: REQUIRED. ANC07 files. The following ANC files 
are required 

ANC07 0000 

ANC07 0003 

ANC07 0004 

ANC07 0006 

Example: INPUT_FILE= ANC07_001_01_0000.DAT 
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Table 20-1 

Description of Control File Contents (Continued) 

OUTPUT_FILE= Value 

REQUIRED. Value should be a string containing the name of 
the output QAP file. 

Example: 

GLA01_012_1102_002_0013_4_01_0001 . QAP 


Table 20-2 Sample Control File 


=PROD_VER 

INPUT_FILE=GLA01_012_1102_002_0013_4_01_0001 . DAT 
INPUT_FILE=anc07_001_01_0000 . dat 
INPUT_FILE=anc07_001_01_0003 . dat 
INPUT_FILE=anc07_001_01_0004 . dat 
INPUT_FILE=anc07_001_01_0006 . dat 

OUTPUT_FILE=gla01_012_l 1 02_0 02_0 0 13_4_01_Integ_0 0 01 . qap 
= END 
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Section 21 

QAPCompare 


21.1 Introduction 

Program Name: QAPCompare. 

Language: Interactive Data Language (IDL) 

Function: Generate Quality Assurance parameters and flags based on data in the QAP files. 

21.2 Overview of Purpose and Functions 

Purpose: Generate product-specific QA parameters to allow data quality assessment, and QA 
flags for inclusion in the metadata. 

Functions: 

1) Generate Metadata flags and parameters from a QA file. 

2) Compare the QA file generated during production of the product granule with the 
QA file generated from the product granule. 

NOTE: It is possible to run the program without the second QA file, in which case only the 
first function is performed. 

NOTE: Flag output is not implemented for all products. 

21.3 Startup and Termination 

To run the program: 

1) Change to a runtime directory 

2) Generate the control file. 

3) The following three directories should be in your path: 
/<GLAS_HOME>/idl/qa_browse/compare 

/ <GL AS_HOME>/ idl/ qa_bro wse/ read 
/<GLAS_HOME>/idl/qa_browse/util 

where GLAS HOME is previously defined in this document. These can be added to your IDL 
path with the command 

IDL> !path = 7<GLAS_HOME>/idl/qa_browse/compare:’ $ 

+ 7<GLAS_HOME>/idI/qa_browse/read:' $ 

+ 7<GLAS_HOME>/idI/qa_browse/util:’ !path 
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issued after you enter IDL and BEFORE you run the program. Here you need to substitute the 
value of GLASHOME in place of each <GLAS_HOME> since IDL does not know what this 
environment variable is. For example, if 

GLASHOME = /data/myworkingdir, 

the actual statement would be 

IDL> !path = Vdata/myworkingdir/idl/qabrowse/compare:' $ 

+ '/data/myworkingdir/idl/qa browse/read:' $ 

+ Vdata/myworkingdir/idl/qabrowse/util:' !path 

4) Either 

a) [i] Enter IDL and at the IDL prompt type 
IDL> qapcompare, controlFileName 
[ii] Exit from IDL. 

OR 

b) at the shell prompt or in a script, enter 

$> runcompare controlFileName 

5) Move the output fdes (if you generated any) to wherever they belong, if necessary. 

21.4 Functions and Their Operation 

The main functions of this program are: 

• Read the control file 

• Read the QAP file(s) 

• Generate the AUTOQA parameters and flags based on data in the QAP file that was 
made along with the product granule. 

• Generate the OPERQA parameters and flags if one or more are defined for the prod- 
uct. 

Optionally, generate the VAV file giving detailed comparison of two QAP files. 

21.5 Input Arguments 

21.5.1 Control File 

This program requires the name of a control file as a command-line argument. The program 
reads input from the control file to determine control parameters. A sample control file is pro- 
vided in the code directory (sample.txt), and a description of the file is given below. 
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21.6 Input Files 

21.6.1 Control File 

The program reads through the control file until it finds a line containing 
=QAPCOMPARE 

and nothing else. The = sign must be in column 1 and there may be no spaces in the line. It 
reads and interprets all lines following this until it finds another line with an = sign in column 
1, at which point the program stops reading, closes the control file, and begins processing. 
Blank lines and lines with a # in column 1 are ignored. All other lines are expected to have the 
form 

KEY=Value, 

and they may be in any order. Spaces around the = sign are ignored, so 
KEY = Value 
is treated the same as 
KEY=Value 

An example file accompanies the distribution, in file sample.txt. 


Table 21 -1 KEY=Value Entries for QAPCompare 


KEY=Value Entry 

Description 

QAP_FILE=Value 

REQUIRED. Value should be a string containing 
the name of the QAP file generated along with the 
product granule. It is assumed that the file name is 
of the form "path/GGGxx..." (without the quotes), 
where xx is a 2-digit number between 01 and 15. 
"path/" is the full path to the file, and may be left off 
if the file is in the working directory, and "GGG" is 
exactly 3 characters, "path" and "GGG" may be 
any mix of upper and lower case characters, which 
must correspond exactly to the actual path and file 
names. 


EXAMPLE: 

QAP FILE=GLA01 012 1102 002 0013 4 01 0 
001. QAP 

QVV_FILE=Value 

OPTIONAL as of 2003 October. Value should be a 
string containing the name of the QAP file gener- 
ated from the product granule. It's format is identi- 
cal to the format of QAP FILE. 


EXAMPLE: 

QVV FILE=GLA01 012 1102 002 0013 4 01 0 
011. QAP 
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Table 21-1 KEY=Value Entries for QAPCompare (Continued) 


OUTPUT_VAV=Value 

OPTIONAL. Name of the VAV file to be written by 
the program. Ignored if QVV_FILE is not present. 
May include a path. 

EXAMPLE: 

OUTPUTVAV = GLA01 .VAV 

OUTPUT_QAPFLAGS=Valu 

e 

REQUIRED. Value should be a string containing 
the name of the QAPFIags file to be written by the 
program. May include a path. 

EXAMPLE: OUTPUTQAPFLAGS = GLA01. QAP- 
FIags 

DOALONGTRACK=Value 

OPTIONAL. Value should be TRUE or FALSE. 

TRUE ==> compare the along-track records. 
FALSE ==> do NOT compare the along-track 
records. 

In general, DOALONGTRACK should be set to 
FALSE for GLA12-15, TRUE for all other products. 

EXAMPLE: DOALONGTRACK = FALSE 

VERSION=Value 

OPTIONAL for Version >= 4.4. 

REQUIRED for Version < 4.4. 

As of Version 4.4 (GSAS version 4.3), the Version 
is read from the QAP file header. See 
Force_Header keyword. 

EXAMPLE: VERSION=3.6 

NOTE: this is a real number, not a string, so it can- 
not handle subreleases such as 3.4.5. 

See Section 1 9 for details. 

FORCEVERSION 

OPTIONAL. Logical Flag 
If set, use the VERSION specified by the VER- 
SION keyword. Ignore any version that may be in 
the QAP file header. 
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CATCHCANCEL 

OPTIONAL. 

This is a debug flag designed to turn off the 
CATCH error handling function to help trap errors. 
It should NOT be used in production processing. 

CATCHCANCEL=0. Default. CATCH error han- 
dling is in effect. 

CATCHCANCEL=1. CATCH error handling is 
turned off. Program will issue an error message 
and STOP at the point where the error occurs. 

QUIET 

OPTIONAL. 

This is a debug flag and should not be used in pro- 
duction processing. QUIET is used to set IQUIET 
(see IDL documentation for values). 
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21.7 Output 

21.7.1 VAV file 

An ASCII file containing a detailed comparison of the two QAP files. The file contains a list 
of all components of the QAP file summary record and along-track records (if DOALONG- 
TRACK=True), with statistics for each, and a comparison of the two QAP files. The only dif- 
ference from product to product is that the specific components change. 

21.7.2 QAPFIags file 

ASCII file with the QA flags and parameters. 

21.8 Understanding the Output 

21.8.1 QAPFIags File 

The QAPFLAGS file contains a list of product-specific flags and parameters in KEY- 
WORD=Value format. The specific keywords vary from product to product. Sample output 
files for each product follow. 


Table 21-2 Sample QAPFLAGS Files 


KEY=Value Entry 

Description 

GLA01. QAPFIags 

AUTOQA_UTCTime_PctMissing = 0.061842919 
AUTOQA Waveform PctMissing = 0.061842919 
AUTOQA Waveform PctOOB = N/A 
AUTOQA UTCTime FLAG = PASS 
AUTOQA_Waveforms_FLAG = PASS 

GLA02. QAPFIags 

AUTOQA UTCTime PctMissing = 0.0086199466 
AUTOQA PCProf PctMissing = 0.0086199466 
AUTOQA CDProf PctMissing = 0.00861 99466 
AUTOQA PCProf PctOOB = N/A 
AUTOQA CDProf PctOOB = N/A 
AUTOQA UTCTime FLAG = PASS 
AUTOQA PCProf FLAG = PASS 
AUTOQA_CDProf_FLAG = PASS 

GLA03. QAPFIags 

AUTOQA UTCTime PctMissing = 0.0086199466 
AUTOQA Temp PctOOB = N/A 
AUTOQA Voltage PctOOB = N/A 
AUTOQA_UTCTime_FLAG = PASS 
AUTOQA Temperature FLAG = PASS 
AUTOQA_Voltage_FLAG = PASS 
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Table 21-2 Sample QAPFLAGS Files (Continued) 


GLA04.QAPFIags 


GLA05.QAPFIags 


GLA06.QAPFIags 


AUTOQA_BST_PctMissing = 1. 7976931 e+308 
AUTOQA_Gyro_PctMissing = 1.7976931 e+308 
AUTOQAJSTPctMissing = 1 .7976931 e+308 
AUTOQA_LPA_PctMissing = 1.7976931 e+308 
AUTOQA_LRS_PctMissing = 1 .7976931 e+308 
AUTOQA_PRAP_PctMissing = 1.7976931 e+308 
AUTOQA_LPA_FLAG = FAIL 
AUTOQA_PRAP_FLAG = FAIL 
AUTOQA_LRS_FLAG = N/A 
AUTOQA_BST_FLAG = N/A 
AUTOQAISTFLAG = N/A 
AUTOQAGyroFLAG = N/A 

AUTOQA_RANGE_FLAG = PASS 
RANGEPCTMISSING = 34.7800 
ICESHEETNVALIDMEASUREMENTS = N/A 
SEAICENVALIDMEASUREMENTS = N/A 
LANDNVALIDMEASUREMENTS = N/A 
OCEANNVALIDMEASUREMENTS = N/A 

AUTOQA_SURFELEVATION_FLAG = FAIL 
SURFELEVATIONPctOOB = N/A 
SURFROUGHNESS_PctOOB = N/A 
SURFREFLECTANCEPctOOB = N/A 
SURFSLOPE PctOOB = N/A 


GLA07.QAPFIags AUTOQA_ = N/A 

GLA08.QAPFIags AUTOQA_ = N/A 

GLA09.QAPFIags AUTOQA_ = N/A 

GLA1 0.QAPFIags AUTOQA_ = N/A 

GLA1 1 .QAPFIags AUTOQA_ = N/A 


GLA12.QAPFIags 


GLA1 3. QAPFIags 


AUTOQA_SURFELEVATION_FLAG = PASS 
AUTOQA_SURFROUGHNESS_FLAG = PASS 
AUTOQA_SURFREFLECTANCE_FLAG = PASS 
AUTOQA_SURFSLOPE_FLAG = PASS 
SURFELEVATIONPctOOB = N/A 
SURFROUGHNESS_PctOOB = N/A 
SURFREFLECTANCEPctOOB = N/A 
SURFSLOPEPctOOB = N/A 

AUTOQA_SURFELEVATION_FLAG = PASS 
AUTOQA_SURFREFLECTANCE_FLAG = PASS 
SURFELEVATIONPctOOB = N/A 
SURFROUGHNESS PctOOB = N/A 
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Table 21-2 Sample QAPFLAGS Files (Continued) 


GLA14.QAPFIags 

AUTOQA SURFELEVATION FLAG = PASS 
AUTOQA SURFROUGHNESS FLAG = PASS 
AUTOQA SURFREFLECTANCE FLAG = PASS 
AUTOQA SURFSLOPE FLAG = PASS 
SURFELEVATION PctOOB = N/A 
SURFROUGHNESS PctOOB = N/A 
SURFREFLECTANCE PctOOB = N/A 
SURFSLOPEPctOOB = N/A 

GLA15.QAPFIags 

AUTOQA SURFELEVATION FLAG = PASS 
AUTOQA SURFROUGHNESS FLAG = PASS 
AUTOQA SURFREFLECTANCE FLAG = PASS 
SURFELEVATION PctOOB = N/A 
SURFROUGHNESS PctOOB = N/A 
SURFREFLECTANCE PctOOB = N/A 


21.8.2 VAV file 

The VAV file has four sections. The sections are separated by lines of dashes. A sample VAV 
file is given after the descriptions. 

21.8.3 VAV file section 1 

The file starts with the names of the files being compared, followed by a description of the 
contents of sections 2 and 3, and ends with the number of matching along-track records. 

21.8.4 VAV file Section 2 

Section 2 starts with the line "ALONG-TRACK STATISTICS:". This is followed by statistics 
summarizing the data in each parameter and a comparison of the data in the two files. All 
along-track parameters are vectors. A sample of the beginning of this section is given below. 
The four lines of information for each parameter contain 

Line 1 : The AVERAGE value of the parameter, the Min, the Max, and the Standard Deviation 
for file 1 . 

Line 2: The same, for file 2 

Line 3: The difference: File 2 - File 1 

Line 4: The % difference: 100 * diff / File 2 value 

21.8.5 VAV file Section 3 

Section 3 starts with the line "SUMMARY STATISTICS:". This is followed by statistics sum- 
marizing the data in each parameter in the QAP summary record and a comparison of the data 
in the two files. Summary records contain both scalar and array data. All array data are treated 
as vectors. A sample of the beginning of this section is given below. 

The information for array data has the same format as for vectors. See section 10.2.2 for a 
description. For scalar variables, the output consists of one line containing (in order) 

the name of the parameter 
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the value from the QAP file 
the value from the QVV file 
the difference (QAP-QVV) 

- the % difference (100 (QAP-QVV) / QVV ) 

21.8.6 VAV file Section 4 

Section 4 summarizes the comparison of the two QAP files. It starts with a description of the 
comparisons. A sample section is given below. 

The statistics are: 

1) The avg, min, max, and standard deviation of the % differences for all items for 
which a comparison was made. 

2) The number of parameters included in 1 . 

3) The maximum number of parameters that could have been included in 1 . This 
excludes items not available in output from QAPG. 

4) The number of items that can be calculated from the product alone (i.e., the number 
of items available in QAP files written by QAPG). 

5) The number of items with good data for which the % difference could not be calcu- 
lated because the file 2 value was zero (so would cause a divide by zero error). 

6) The number of discrepancies (unexpectedly large differences). 

7) The number of parameters that were invalid unexpectedly. 

8) The number of along-track records for which the times or locations did not agree. 
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Table 21-3 Sample VAV File 


COMPARING CONTENTS OF 

FILE 1: /XOVER/disk4/jack/glas/Mantis795/ 

GLA01_012_1102_002_0013_4_01_0001 . QAP 

FILE 2: /XOVER/disk4/jack/glas/Mantis795/ 

GLAO 1_0 12_1 1 02_0 0 2_0 0 13_4_0 l_qapg_0 0 01. qap 
For vector data: Average, Min, Max, Standard deviation of 
Line 1: File 1 data 
Line 2 : File 2 data 

Line 3 : Dif f = File 2 data - File 1 data 
Line 4: 100 * Diff / File 2 data 

For scalar data: File 1 datum. File 2 datum, Diff = File 2 datum - File 1 datum, 
100 * Diff / File 2 datum 

Not Avail = the item is not present in one or both files and it can not be 
calculated from the product file alone. 

No Data = the item is not present in one or both files. It should be 
possible to calculate it from the product file alone 
Invalid = the value is zero in File 2 so the ratio is undefined. 

+++ = bad data found for File 1 

XXX = bad data found for File 2 

*** = bad data found for both files 

OOO = problem with comparison of File 1 and File 2 for this item 

NUMBER OF MATCHING ALONG-TRACK RECORDS: 101 


ALONG-TRACK STATISTICS: 


DQATIMEl : 

9 . 94E+07 

9 . 94E + 07 

9 . 94E + 07 

4 . 69E+02 


9 . 94E+07 

9 . 94E + 07 

9 . 94E + 07 

4 . 69E + 02 


-3 .26E-08 

-4 . 77E-07 

5 . 07E-07 

2 . 85E-07 


-3 .28E-14 

-4 . 80E-13 

5 . 10E-13 

2 . 87E-13 


PREDOM_WAVE : 

6 . 34E-01 

0 . 00E + 00 

1 . 00E+00 

4 . 84E-01 


6 . 34E-01 

0 . 00E + 00 

1 . 00E + 00 

4 . 84E-01 


0 . 00E+00 

0 . 00E+00 

0 . 00E+00 

0 . 00E+00 


0 . 00E+00 

0 . 00E + 00 

0 . 00E+00 

0 . 00E + 00 
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Table 21-3 Sample VAV File (Continued) 


SUMMARY STATISTICS: 


DQATIME1 : 

9 . 94E+07 

DQATIME2 : 

9 . 94E+07 

I_EXP_APID19 : 

1617 

I _NUM_AP I D 1 9 : 

1616 

I_LFILTNUM_CNT : 

4 . 90E+03 
4 . 90E+03 
0 . 00E+00 
0 . 00E+00 

I_SFILTNUM_CNT: 

1.27E+03 
1.27E+03 
0 . 00E+00 
0 . 00E+00 


Not Avail 

Not Avail 

Not Avail 

XXX 

Not Avail 

Not Avail 

Not Avail 

XXX 

Not Avail 

Not Avail 

Not Avail 

XXX 

1616 

0 

0 . 00 


1 .40E+03 

1 . 05E+04 

3 . 16E+03 


1.40E+03 

1 . 05E+04 

3 . 16E+03 


0 . 00E+00 

0 . 00E+00 

0 . 00E+00 


0 . 00E+00 

0 . 00E+00 

0 . 00E+00 


1 . 15E+02 

4 . 90E+03 

1 . 81E+03 


1 . 15E+02 

4 . 90E+03 

1 . 81E+03 


0 . 00E+00 

0 . 00E+00 

0 . 00E+00 


0 . 00E+00 

0 . 00E+00 

0 . 00E+00 



Summary information 


Summary : 

N in Summary : 


Max N in summary: 
N Not in Product : 

N Zero: 


N Discrepencies : 

N Bad Data Found: 
N Non-matching: 


avg, min, max, std dev of the % differences 

Number of points in summary statistics. This can be different 
from the "Max N in summary" for several reasons : 

a. The % diff cannot be calculated if the quantity from file 
2 is 0 while the quantity from file 1 is not exactly 0, so 
the ratio is not defined. The number of such items is 
given seperately as "N Zero." 

b. Items that cannot be calculated from the product alone 
will be missing if one of the QAP files was generated 
after production processing. 

c. If the values are invalid in one or both QAP files, the 
item is not included in the total. If a value is invalid 
in only one file, and should be present in both (see b) , 
this is a discrepency. 

Maximum number of items that could be in the summary. 

Number of items that cannot be calculated from data in the 
product file alone 

Number of items with good data for which the % difference 
could not be calculated because the value for file 2 (but not 
file 1) was zero, making the ratio infinite. 

Number of items for which an unexpected difference was found 
Number of items for which unexpected bad data were found 
Number of along-track records for which the start/end 
times (QAP1,2,5) or lat/lon (QAP6, 12-15) are different. 

Not applicable to other products. 
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Table 21-3 Sample VAV File (Continued) 


SUMMARY : 

-4 . 68E-03 

-3 . 81E+01 

2 . 30E+01 

4 . 69E-02 

MAX N IN SUMMARY: 

84 




N NOT IN PRODUCT: 

10 




N ZERO: 

0 




N DISCREPENCIES : 

0 




N BAD DATA FOUND: 

11 




N IN SUMMARY: 

73 




N NON-MATCHING: 

0 




11.0 Error and Warning 

Messages 





21.9 Error and Warning Messages 

All warning and error messages generated by the program are self-explanatory. Any error 
messages generated by IDL should be reported. 

In addition to errors and warnings written to stderr and stdout, the program generates an exit 
code. The exit codes used are specified in /vobs/glas/idl/qa_browse/util/qa_exitcodes.pro. 


2 1.10 Recovery Steps 

Exit IDL, correct the error in the control file, and start over. 
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Section 22 

Creating a Global DEM and Replacing Greenland 
and Antarctica DEM with New Grids 

22.1 Global DEM 

1) Download the SRTM30 data from http://edcftp.cr.usgs.gov/pub/data/srtm/ 
SRTM30/ 

e020n40.dem.zip 

e060n40.dem.zip 

el00n40.dem.zip 

el40n40.dem.zip 

w020n40.dem.zip 

w060n40.dem.zip 

wl00n40.dem.zip 

wl40n40.dem.zip 

wl80n40.dem.zip 

e020n90.dem.zip 

e060n90.dem.zip 

el00n90.dem.zip 

el40n90.dem.zip 

w020n90.dem.zip 

w060n90.dem.zip 

wl00n90.dem.zip 

wl40n90.dem.zip 

wl80n90.dem.zip 

e020sl0.dem.zip 

e060sl0.dem.zip 

el00sl0.dem.zip 

el40sl0.dem.zip 
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w020sl0.dem.zip 

w060sl0.dem.zip 

wl00sl0.dem.zip 

wl40sl0.dem.zip 

wl80sl0.dem.zip 

2) Download the Antarctica data from http://edcdaac.usgs.gov/gtopo30/gtopo30.html 
w060s60.tar.gz 

wl80s60.tar.gz 

wl20s60.tar.gz 

w000s60.tar.gz 

e060s60.tar.gz 

el20s60.tar.gz 

3) Ftp all the files to the working directory 
All in the working directory 

4) Unzip the zip files 

(unzip for *.zip, gunzip and tar xvf for *.tar.gz) 

5) Run the following programs: 

merge40 to merge the data file of latitude -10 to 40 degrees 
merge90 to merge the data file of latitude 40 to 90 degrees 
merges 10 to merge the data file of latitude -60 to -10 degrees 
mergesAntar to merge the data file of latitude -90 to -60 

6) Run mergeall to merge all the data files to the final file:GLOBAL.dem 

7) Run interp_ourgrid_to30secDEM to replace a new grid in Antarctica and Green- 
land. 

Replacing Antarctica grid: 
interp_ourgrid_to30secDEM /de 1/newgrids/ 

ac_gmJGM3_erslDGM_5km_slcr.GRID-egm96 GLOBAL. dem tempfile 

Replacing Greenland grid: 

interp_ourgrid_to30secDEM /de 1/newgrids/ 
gc_gmJGM3_erslDGM_5km_slcr.GRID-egm96 

tempfile NEWGLOBAL.dem. 

8) Run create_newgrid to add data above 89.995833 and below -89.995833 deg lat 
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The final file is NEWGLOBAL.dem. 

9) Run convrtldeg new to create the one degree mask identifying region types in 
them (ocean or land or mix) 

The final file is ONEDEG.MASK. 

10) Run crldegDem to create DEM.MASK file that has 0 for ocean, and if not 0, i.e. 
land, then the value is the record number of the new global dem containing that 1 
deg segment. 

It also creates LAND. DEM that contains only land dem. 

1 1) Run unit test to read the LAND.DEM and DEM.MASK and compares the data val- 
ues to a test data in testdempoints.out. 
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Section 23 

prod_util 


23.1 Function 

The content of produtil is a set of non-production product-related utilities. There are six util- 
ities present: scantime, proc_wf, product_test, gsas_prod_readers, strip 1984 and stripper. 

Only stripper, scantime, and proc wf are based on the standard GSAS PGE model. Therefore, 
no multi-granule or multi-file support is provided, no time selection is available, and no con- 
trol files are necessary for the other utilities. 

Note: The prod util routines are not intended for production use. 

23.2 scantime 

scantime is a utility which reads ANC29, ANC23, APID19 and APID1984 and detects sec- 
ondary header time resets. This can be used to assist in the generation of ANC33 updates, 
scantime uses a standard GSAS control file. 

Required input files are listed in Table 23-1. 


Table 23-1 scantime Inputs 


File Spec 

Type 

Source 

Short Description 

gla00*_001 9.dat 

Level-0 APID 

EDOS 

GLAS Level-0 APID19. 

gla00*_1 984.dat 

Level-0 APID 

EDOS 

GLAS Level-0 APID1984. 

anc07*_0000.dat 

Static Ancillary 

Science Team 

GLAS error file. 

anc07*_0001 .dat 

Static Ancillary 

Science Team 

GLAS global constants file. 

anc25*.dat 

Dynamic Ancillary 

Science Team 

GPS/UTC conversion file. 

anc33*.dat 

Dynamic Ancillary 

ISIPS Operations 

Counter-to-UTC conversion file. 

Control File 

Control 

ISIPS Operations 

Control file. 


Output files are listed in Table 23-2. 


Table 23-2 scantime Outputs 


File Spec 

Type 

Destination 

Short Description 

anc33*.dat 

Dynamic Ancillary 

ISIPS Operations 

Suggested replacement ANC33 
file. 

anc06*.dat 

Dynamic Ancillary 

ISIPS Operations 

Standard metadata/processing 
log file. 


The control file section delimiter for scantime is: 
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= SCANT I ME 

23.3 product_test 

producttest is used to verify product formats in a testing environment. It contains programs 
which write product data records with minimum, maximum, and intermediate values. Other 
programs read what has been written to verify that no change was detected in the values read 
versus the values written. Two executables (glaxx_writer and glaxx_reader) are provided for 
each GLA filetype. 

glaxx writer requests the name of an output GLAxx product file from the user and writes data 
records to that file, as well as creating the text-based output files described in Table 23-3. 


Table 23-3 glaxx writer outputs 


Output File 

Description 

filename, write. seal 

contains text-format scaling values for the appropriate product. 

///ename.write.prod 

contains text-format product (scaled) values for each data record written. 

filename, write. alg 

contains text-format algorithm (unsealed) values for each data record written. 


glaxx reader requests the name of an input GLAxx product file from the user and then reads 
that file to create text-based output files described in Table 23-4. 


Table 23-4 glaxx_reader outputs 


Output File 

Description 

filename, read. seal 

contains text-format scaling values for the appropriate product. 

filename, read, prod 

contains text-format product (scaled) values for each data record written. 

filename, read, alg 

contains text-format algorithm (unsealed) values for each data record written. 


Once glaxx writer creates the output file and glaxx reader reads it, the resulting text output 
files can be compared to detennine if any data were lost or changed during the input/output 
process. 

23.4 gsas_prod_readers 

gsas_prod_readers are sample product readers which are can be distributed independent from 
the rest of GSAS. These are designed to provide external data users with sample code for 
reading the GLAS products. The gsas_prod_readers are fully documented in a separate docu- 
ment which can be provided to the data users along with the code. 

23.5 strip1984 

strip 1984 is a small utility which strips extraneous data from the APID1984 packets. This was 
created because extra infonnation was added to the 1984 packets during GSFC testing. 
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strip 1984 requests the name of an input 1984 APID file. It reads the secondary header of the 
first data record to detennine the correct record length and then writes the trimmed records to 
an output file. The output filename is the input filename with ‘.stripped’ appended to it. 

23.6 stripper 

stripper is a utility written to help process spacecraft test data. It subsets APIDs by selecting 
data which fall within the specified MET count range. It is modeled after a full-fledged PGE 
using a slightly modified control file format (MET counts are substituted for UTC seconds in 
the time specification). 

23.7 procwf 

proc wf is a utility that decompresses the GLAS waveform from a GLAO 1 granule and time 
aligns data and parameters from the GLAO 1 granule with data and parameters from the corre- 
sponding GLA05 granule. 
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Section 24 

create_regionsMASK_util 


24.1 Introduction 

This document details the procedure to be followed to create a surface type grid fde for use by 
GLAS. 

24.2 Related Documentation 

GSAS Design Document Common Appendices 
Surface Type Grid Creation Utility Design Document 

24.3 Overview of Purpose and Functions 

The create regionsMask.pro utility consists of two subroutines (combine and minsurfmasks) 
that have to be called to create the fine and coarse surface type grid files. The combine rou- 
tine will combine the four surface type grid files (ice sheet, sea ice, land, and ocean) to create 
one global surface type grid file. The minsurfmasks routine will read the global surface type 
grid file, and create a coarse surface type grid file and a fine surface type grid file. The fine 
surface type grid file contains 2 x 2 arc minute cells. 

24.4 Installation and Initialization 

This program has been compiled and tested under the following environment: 

OS: HP-UX 11.00 

CompilerTDL Version 5.4 

24.5 Startup and Termination 

To run the utility programs: 

Change to the runtime directory 

Link in the masks files 

Delete or rename any old output files 

Type “create_regionsmask < control_file” 

Make sure that the run regionsmaskprog, control file, and create regionsMask.pro 
files are all linked (or present) in the runtime directory 

If the program completes without error and the output files are created, then the program has 
completed successfully. Abnormal execution will result in an error. Two additional files 
(maskl.test and mask2.test) are created. These are test files containing the ASCII version of 
the data in surf_ldeg_mask.dat and surf_2min_mask.dat files. They are only used for debug- 
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ging purposes. The combined regions mask file, and the coarse and fine regions mask files 
are created with the names entered in the control file. 


24.6 Functions and Their Operation 

The create regionmask batch file will call the idl script runregionsmaskprog. This will com- 
pile and execute the create regionsMask.pro idl routine. The main function of this idl routine 
are: 

combine 

Combining the individual surface masks file into one global surface masks file. The 
shape and size of the combined surface masks file is the same as the individual surface 
masks file. 

minsurfmasks 

Reading the global surface masks file and creating a coarse grid (lxl deg) and a fine 
grid (2x2 minute) file. 


24.7 Input Arguments 

24.7.1 Control File 

This program requires the name of a control file as a command-line argument. The program 
reads input from the control file to detennine control parameters. The control file contains the 
names of the Predicted orbit file, the ANC07 error file, and the output files. 

The control file fonnat is as follows: 


= CREATE REGIONSMASK 


outMaskFileldeg 

outMaskFile2min 

iceSheetMaskFile 

landMaskFile 

oceanMaskFile 

sealceMaskFile 

combinedMaskFile 


= surface_ldeg_mask.dat 
= surface_2min_mask.dat 
= icesheet_mask 
= landmask 
= oceanmask 
= seaice_mask 
= surface masks.dat 


=END 


The control file must begin and end with an equal sign "=" to designate this as a section. 
CREATE REGIONSMASK is the section name for this program and should not be changed. 
This allows the control section to be included in a larger control file. The structure follows the 
"keyword-' fonnat. It is important that the keywords are the same as in the above example 
since the code reading this file is searching for these words. The keywords may be in upper- 
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case or lowercase. Also, it makes no difference if there are spaces between the keyword, equal 
sign, and parameter name. Following the equal signs are the values which may change (in ital- 
ics). The order of the keywords or file names is not important. 

Refer to the GSAS User's Guide Common Appendices, "Control File Fonnat' ' section for 
additional information on the control file format. 

24.8 Input Files 

Input files consist of the individual surface masks files (ice sheet, sea ice, land, and ocean). 

24.9 Output Files 

The output files are the combined global surface masks file “surface_masks.dat”, and the 
global coarse grid file (surface_ldeg_mask.dat) and the global fine grid file 
(surface_2min_mask.dat). Two ASCII debug files (maskl.test and mask2.test) are also pro- 
duced. 

24.10Understanding the Output 

The output files each have a header record. The coarse file has a 1440 byte record, while the 
fine grid file has a 900 byte record. The combined masks file also has a 900 byte header 
record. The header records lists the individual regions masks files used to create the final 
coarse and fine grid files, as well as other housekeeping infonnation. The header records are 
in ASCII format, and therefore can be easily looked at by perfonning a UNIX head command 
on the files. 

The “surface_ldeg_mask.dat” and “surface_2min_mask.dat” are FORTRAN direct access 
files. The “surface_ldeg_mask.dat” file contains one 4-byte record for each 1-degree lati- 
tude/longitude cell. The value in the record is a 4-byte integer. If the surface type is constant 
throughout the cell, the record contains the negative of the surface type (see SURFACE TYPE 
CODING, below). If the surface type is not constant throughout the coarse cell, the record 
contains the starting location in the fine grid file of the sub grid with the surface types for this 
coarse cell. The location is given as the byte offset from the beginning of the fine grid file. 
Records start at the North Pole, with 0 deg Longitude, and proceed to 360 deg Longitude 
before stepping to the next latitude band, where the sequence is repeated. 

Each record of the “surface_2min_mask.dat” file contains one 30x20 BYTE array. Each cell 
of this array specifies the surface type for one fine cell within the coarse grid to which the 
array corresponds (see SURFACE TYPE CODING, below). The first byte of the array con- 
tains the surface type for the northwest corner of the large cell. Location changes most rapidly 
with longitude. 

SURFACE TYPE CODING 

Allowed values for the surface type are 1 to 15. The surface types are bit-coded, and any com- 
bination of surface type is allowed. The bit coding is: 

1 = ice sheet 
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2 = sea ice 
4 = land 
8 = ocean 

24.11 Error and Warning Messages 

None. 

24. 12 Recovery Steps 

None. 


24.13Abbreviations and Acronyms 

None. 


24.14Glossary 


File A collection of data stored as records and tenninated by a physical or logical 

end-of-file (EOF) marker. The tenn usually applies to the collection within a 
storage device or storage media such as a disk fde or a tape fde. Loosely 
employed it is used to indicate a collection of GLAS data records without a 
standard label. For the Level 1A Data Product, the file would constitute the 
collection of one-second Level 1A data records generated in the SDPS work- 
ing storage for a single pass. 

Program The smallest set of computer instructions that can be executed as a stand- 
alone unit. 


Subroutine A program that is called by another program. 

Variable Usually a reference in a computer program to a storage location, i.e., a place 

to contain or hold the value of a data item. 


24. 15 Notes 

None 

24.16Appendices 

GSAS User's Guide Common Appendices 
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Appendix A 

GLAS File Summary 


This Appendix is a summary of the GLAS File types and provides information about the rec- 
ommended production naming conventions. Full details regarding the GLAS product and 
ancillary files are provided in the GLAS Science Data Management Plan and the GLAS Stan- 
dard Data Products Specifications - Level 1 and Level 2. 

A.1 GLAS Production File Naming Convention 

GSAS creates products and uses various ancillary files and other input products that are track/ 
time dependent, or process-specific and created automatically. Some ancillary files are static 
and others are dynamic. The following scheme outlines the file naming conventions required 
for each file type. 

1) Track dependent products processed at ISIPS (GLA01-15; and corresponding png 
files, qap products, v and v files, and metadata files) 

GLAxx_mmm_prkk_ccc_tttt_s_nn_ffff.eee 

Where eee is dat for GLA01-15 and eee is hdf for GLA16; qap for corresponding 
qap file; png for corresponding non-hdf browse files; vav for corresponding vali- 
dation and verification file; met for metadata files 

Note that the multiple file pngs for GLA01, 02, 03 and 05-15 will use the ffff to 
denote the different files 

2) Time dependent GLA and ANC granules: (GLA00, dynamic ANC time dependent 
files except for ANC06) 

GLAOOmmm vyyymmddh h mmssn nffff.eee and 
ANCxx mmm vyyymmdd h h mmssn n ffff.eee 

Where eee is always dat, xx is the corresponding ANC file number 

yyyymmdd hhmmss is the date time of the first data point in the file 

for GLA00 the ffff has to have a one to one correspondence with the APID num- 
ber. It the apid number is less than 4 digits then the unused portion of the ffff filed 
will be set to 0. The numbers will be filled in from the right most ‘f’ field, i.e. apid 
26 will be denoted as 0026. 

3) Static Ancillary files required for processing (ANC) 

ANCxxmmmnnffff.eee 

Where eee is always dat, xx is the corresponding ANC file number 

4) Log files, ANC06 

AN( ()6 ni m m yyyy inm dd gggggg _nn_pgename.txt 
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yyyymmdd is the creation date 

5) Control files 

CTLmmmyyyymmddggggggnnpgename.ctl 

Where yyyymmdd is the creation date 

6) SCFQA files 

SCFQA_mmm_yyyymmdd_iiiiii_nn.txt 

Where yyyymmdd is the creation date 

Time for process-specific files is processing date. GLAS file naming keys are defined in Table 
A-l. 


Table A-1 GLAS File Naming Keys 


Key 

Description 

XX 

Type ID number (CCB assigned number within a specific GLA or ANC series) 

P 

repeat ground track phase 

r 

reference orbit number 

kk 

instance # incremented every time GLAS enters a different reference orbit 

ccc 

cycle of reference orbit for this phase 

tttt 

track within reference orbit 

s 

segment of orbit. This is 0 on files that contain multiple segments (GLA02, GLA03, 
GLA04,GLA07-GLA1 5) and 1, 2, 3, or 4 on GLA01, GLA05, and GLA06. 

yyyymmdd 

starting date in year, month, and day of month or creation date (see above) 

hhmmss 

starting time hour, minute, second 

mmm 

release number for process that created the produce (CCB assigned-combination of 
software and data) 

nn 

granule version number (the number of times this granule is created for a specific 
release) 

iii 

counting sequence number (incremental sequence per day for each instance of a 
process specific ANCxx or GLAxx) 

ffff 

file type (numerical, CCB assigned for multiple files as needed for data of same time 
period for a specific ANCxx or GLAxx, .i.e. multi-file granule) 

eee 

descriptor telling whether data product, browse product, quality assurance product, 
validation and verification output. Valid eee values are dat, png, hdf, qap, vav, and 
met 

dddd 

‘brws’ denotes consolidated multi-png file browse product in hdf 
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Table A-1 GLAS File Naming Keys (Continued) 


Key 

Description 

gggggg 

job id number - number of digits may change. 

pgename 

GLAS ATM, GLAS LOP, met util, GLAS L1A, GLAS Meta, ATM ANC, met util, 
GLAS_ALT, QABROWSE, ExtractRev 


A.2 EDOS LO File Naming Convention 

EDOS-delivered files have a different naming convention than standard GLAS product files. 
The EDOS LO files will be renamed as part of the ingest process. Incoming filenames are as 
follows: 

f ooooooottttttthhhhhhhdddddddddddiuu . eeee 
Table A-2 defines keys for the EDOS file naming convention. 


Table A-2 EDOS LO File Naming Keys 


Key 

Description 

f 

E (for EDS) or P (for PDS) (1 byte) 

0000000 

First APID in data set (SCID 3 bytes, APID 4 bytes) 

ttttttt 

Second APID in data set (SCID 3 bytes, APID 4 bytes) 

hhhhhhh 

Third APID in data set (SCID 3 bytes, APID 4 bytes) 

ddddddddddd 

creation GMT/ZULU time (11 bytes) 

1 

numeric identification (0-9) (1 byte) 

uu 

Unique file number (00-99) (2 bytes) 

eeee 

File naming extension PDS or EDS (4 bytes) 


A.3 GLAS File Types 

Table A-3 lists GLAS file IDs, a short description, and file type for each file used in GSAS. 
Note that QAP files, which correspond to each product file, are not listed. The “multi” column 
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indicates if a file type is a multi-file granule. These means there are multiple subtypes within 
each file type. 


Table A-3 GLAS File Types 


File 

Type 

Short Description 

Type 

Multi 

ANC01 

Meteorological Data 

Dynamic Anc 

Yes 

00=header 
01=precip water 
02=height 
03=rel humidity 
04=temperature 

ANC03 

Laser Tracking Data 

Dynamic Anc 

No 

ANC04 

IERS Rotation 

Dynamic Anc 

No 

ANC05 

Magnetic and Solar Flux 

Dynamic Anc 

No 

ANC06 

GLAS Metadata and Log 

Dynamic Anc 

No 

ANC07 

GLAS Coefficients and Constants 

Static Anc 

Yes 

00=errors 

0 1 =global 

02=atmosphere 

03=elevation 

04=waveform 

05=L1 A 

06=utility 

ANC08 

Precision Orbit Data 

Dynamic Anc 

No 

ANC09 

Precision Attitude Data 

Dynamic Anc 

No 

ANC10 

GPS Tracking 

Dynamic Anc 

No 

ANC11 

Instrument Trend 

Dynamic Anc 

No 

ANC12 

Digital Elevation Model 

Static Anc 

Yes 

00=DEM 

01=Mask 

ANC13 

Geoid 

Static Anc 

No 

ANC16 

Load Tide Model 

Static Anc 

No 

ANC17 

Ocean Tide Model 

Static Anc 

No 

ANC18 

Standard Atmosphere 

Static Anc 

No 

ANC20 

Predicted Orbit 

Dynamic Anc 

No 

ANC21 

Science Trend Data 

Dynamic Anc 

No 

ANC22 

Reference orbit 

Dynamic Anc 

No 

ANC23 

Reference ascending node 

Dynamic Anc 

No 
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Table A-3 GLAS File Types (Continued) 


File 

Type 

Short Description 

Type 

Multi 

ANC25 

GPS-UTC time 

Dynamic Anc 

No 

ANC26 

Reference Orbit Ephemerides 


No 

ANC27 

Regional masks 

Static Anc 

No 

ANC28 

Rev node table 

Dynamic Anc 

No 

ANC29 

Index 

Dynamic Anc 

No 

ANC30 

Global aerosol categorization map 

Static Anc 

No 

ANC31 

Aerosol tropospheric classification map) 

Static Anc 

No 

ANC32 

GPS time correction 

Dynamic Anc 

No 

ANC33 

MET Counter to UTC conversion 

Dynamic Anc 

No 

ANC34 

BCTCW counter to UTC conversion 

Dynamic Anc 

No 

ANC35 

Ozone 

Static Anc 

No 

ANC36 

Atmosphere Utility 

Dynamic Anc 

No 

ANC37 

Spacecraft CG 

Dynamic Anc 

No 

ANC38 

Multiple-scattering table 

Dynamic Anc 

No 

ANC39 

GPS Data 

Dynamic Anc 

No 

ANC40 

Raw Meteorological File 

Dynamic Anc 

No 

ANC41 

JPL Planetary Ephemeris 

Dynamic Anc 

No 

ANC42 

Reference Orbit Table 

Dynamic Anc 

No 

ANC43 

Track File 

Dynamic Anc 

No 

ANC44 

Atm 1064 Cirrus CAL File 

Dynamic Anc 

No 

ANC45 

Product Metadata template files 

Static Anc 

Yes 

01=GLA01 

02=GLA02 

etc... 

ANC46 

Ancillary Metadata template files 

Static Anc 

Yes 

04=ANC04 

08=ANC08 

etc... 

ANC47 

EDOS Construction Records 

Dynamic ANC 

yes (one file per 
APID type) 

ANC48 

GLAS MCF File 

Static Anc 

Yes 

01 for GLA01 
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Table A-3 GLAS File Types (Continued) 


File 

Type 

Short Description 

Type 

Multi 

ANC49 

GLAS Ancillary MCF File 

Static Anc 

Yes 

01 forGLAOl 

ANC50 

00 for Merged ANC09/ANC32 File 

01 for Frequency Trend File 

Dynamic ANC 

Yes (see short 
description) 

ANC51 

SRTM DEM Data 

Static Anc 

Yes 

ANC52 

Saturation Correction Tables 

Static Anc 

Yes 

01=range 
02=energy 
03=pulse width 

GLA00 

GLAS Instrument Packet File (APIDs) 

Product 

yes (one file per 
APID type) 

GLA01 

Altimetry Data 

Product 

No 

GLA02 

Atmosphere Data 

Product 

No 

GLA03 

Engineering Data 

Product 

No 

GLA04 

SRS and GPS Data 

Product 

Yes 

01=LPA 

02=LRS 

03=GYRO 

04=IST 

05=BST 

06=SCPA 

GLA05 

Waveform-based Range Corrections 

Product 

No 

GLA06 

Elevation 

Product 

No 

GLA07 

Backscatter 

Product 

No 

GLA08 

Boundary Layer and Aerosol Layer Heights 

Product 

No 

GLA09 

Cloud Height for Multiple Layers 

Product 

No 

GLA10 

Aerosol Vertical Structure 

Product 

No 

GLA11 

Thin Cloud/Aerosol Optical Depth 

Product 

No 

GLA12 

Ice Sheet Products 

Product 

No 

GLA13 

Sea Ice Products 

Product 

No 

GLA14 

Land Products 

Product 

No 

GLA15 

Ocean Products 

Product 

No 
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A.4 GLAS File Associations 

Table A-4 lists each GLAS file and its associated source or PGE. Those inputs in italics are 
for special processing scenarios. Note that GLAS Reader, though not listed as a destination, 
can read most of these files. 


Table A-4 GSAS File Associations 


File 

Type 

Short Description 

Source 
(output from) 

Destination 
(input to) 

ANC01 

Meteorological Data 

met_util 

GLAS Alt 
GLAS_Atm 

ANC04 

IERS Polar Motion and Earth Rotation Data 
File. 

UTexas 

GLAS_Alt, 

GLAS_Atm 

ANC06 

GLAS Metadata and Log 

All core PGEs 

Archive 

ANC07 

GLAS Coefficients and Constants 

Science Team 

All PGEs 

ANC08 

Precision Orbit Data 

UTexas 

GLAS Alt 
GLAS_Atm 

ANC09 

Precision Attitude Data 

UTexas 

GLAS Alt 
GLAS_Atm 

ANC12 

Digital Elevation Model 

Science Team 

GLAS Alt 
GLAS_Atm 

ANC13 

Geoid 

Science Team 

GLAS Alt 
GLAS_Atm 

ANC16 

Load Tide Model 

Science Team 

GLAS_Alt 

ANC17 

Ocean Tide Model 

Science Team 

GLAS_Alt 

ANC18 

Standard Atmosphere 

Science Team 

GLAS_Atm 

ANC20 

Predicted Orbit 

UTexas 

createGran, 
GLAS LI A, 
GLAS Alt, 
GLAS_Atm 

ANC25 

GPS-UTC time 

UTexas 

GLAS_L1A 

ANC27 

Regional masks 

Science Team 

GLAS_Atm 

ANC29 

Index files 

GLAS_L0proc 

GLAS_L1A 

ANC30 

Global aerosol categorization map 

Science Team 

GLAS_Atm 

ANC31 

Aerosol tropospheric classification map) 

Science Team 

GLAS_Atm 

ANC32 

GPS time correction 

GLAS_L0proc 

GLAS_L1A 

ANC33 

MET Counter to UTC conversion 

Instrument Team 

GLAS_L0proc 

ANC35 

Ozone file 

Science Team 

Atm_anc 
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Table A-4 GSAS File Associations (Continued) 


File 

Type 

Short Description 

Source 
(output from) 

Destination 
(input to) 

ANC36 

Atmosphere Utility 

Atm_anc 

GLAS_Atm 

ANC40 

Raw meteorological file. 

GSFC DAAC 

met_util 

ANC44 

Atm 1064 Cirrus CAL File 

atm_anc 

Science Team 

ANC45 

Product Metadata template files 

Science Team 

GLAS LI A 
GLAS Atm 
GLAS_Alt 
GLAS_Meta 

ANC46 

Ancillary Metadata template files 

Science Team 

GLAS_Meta 

ANC47 

EDOS Construction Records 

EDOS 

GLAS_L0proc 

ANC50 

Merged ANC09/ANC32 File, or Frequency 
Trend File 

GLASTick 

Instrument Team 

ANC51 

SRTM DEM Data 

Science Team 

GLAS_Alt 

ANC52- 

01 

Range Saturation Correction Table 

Science Team 

GLAS_Alt 

ANC52- 

02 

Energy Saturation Correction Table 

Science Team 

GLAS_Alt 

ANC53 

Time-based aerosol tropospheric map 

Science Team 

GLAS_Alt 

ANC54- 

01 

GLAS Derived DEM-Greenland index 

Science Team 

GLAS_Alt 

ANC54- 

02 

GLAS Derived Ik DEM over Greenland 

Science Team 

GLAS_Alt 

ANC54- 

03 

GLAS Derived DEM-Antarctica index 

Science Team 

GLAS_Alt 

ANC54- 

04 

GLAS Derived 500m DEM over Greenland 

Science Team 

GLAS_Alt 

ANC54- 

05 

Canadian DEM Index File 

Science Team 

GLAS_Alt 

ANC54- 

06 

Canadian DEM Elevation File for (231-299 
degrees east, 70-82 degree north) 

Science Team 

GLAS_Alt 

ANC55 

Mean Sea Surface 

Science Team 

GLAS_Alt 

ANC56 

Pole Tide 

Science Team 

GLAS_Alt 

ANC57 

Global Bathymetry 

Science Team 

GLAS_Alt 

ANC58 

Ground Track 

Science Team 

GLAS_Alt 

ANC59 

Pointing Mode Table 

Science Team 

GLAS_Alt 
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Table A-4 GSAS File Associations (Continued) 


File 

Type 

Short Description 

Source 
(output from) 

Destination 
(input to) 

ANC70 

SCF Constants File 

SCF 

SCF 

GLA00 

GLAS Instrument Packet File (APIDs) 

EDOS 

GLAS LOproc, 
GLAS_L1A 

GLA01 

Altimetry Data 

GLAS_L1A 

GLAS_Alt, 

Archive 

GLA02 

Atmosphere Data 

GLAS_L1A 

GLAS_Atm, 

atm_anc, 

Archive 

GLA03 

Engineering Data 

GLAS_L1A 

GLASTick, 

Archive 

GLA04 

SRS and GPS Data 

GLAS_L1A 

GLAS_L1A, 
UTexas, Archive 

GLA05 

Waveform-based Range Corrections 

GLAS_Alt 

GLAS_Alt, 

Archive 

GLA06 

Elevation 

GLAS_Alt 

GLAS_Alt, 

Archive 

GLA07 

Backscatter 

GLAS_Atm 

GLAS_Atm, 

Archive 

GLA08 

Boundary Layer and Elevated Aerosol Layer 
Heights 

GLAS_Atm 

Archive 

GLA09 

Cloud Height for Multiple Layers 

GLAS_Atm 

GLAS_Alt, 

Archive 

GLA10 

Aerosol Vertical Structure 

GLAS_Atm 

Archive 

GLA11 

Thin Cloud/Aerosol Optical Depth 

GLAS_Atm 

GLAS_Alt, 

Archive 

GLA12 

Ice Sheet Products 

GLAS_Alt 

Archive 

GLA13 

Sea Ice Products 

GLAS_Alt 

Archive 

GLAM 

Land Products 

GLAS_Alt 

Archive 

GLA15 

Ocean Products 

GLAS_Alt 

Archive 
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Appendix B 

ANC07 Format, Files and Contents 


B.1 ANC07 Format 

ANC07 files are in standard GSAS “keyword=value” fonnat. ANC07 files contain sections 
for errors messages, status messages, global constants, and subsystem-specific constants. Sec- 
tions may be combined into a single file or separated into multiple files. Not all sections need 
be present. The sections are delimited as follows: 

BEG_OF_STATUS= 

. . .Status section contents. . . 

END_0 F_S TATU S = 

BEG_OF_ERROR= 

. . .Error section contents. . . 

END_OF_ERROR 

BEG_OF_GLOBALS= 

...Global constants section contents... 

END_0 F_GLOB AL S 

B E G_0 F_ATM = 

...Atmosphere constants section contents... 

END_OF_ATM 

BEG_OF_ELEV= 

...Elevation constants section contents... 

END_OF_ELEV 

BEG_0F_L1A= 

. . . L1A constants section contents. . . 

END_0F_L1A 

BEG_OF_UTIL= 

...Utility constants section contents... 

END OF UTIL 
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B.2 ANC07 Files 

In production, ANC07 is defined as a multi-granule file with a single granule representing a 
different section (for the most part). Table B-l lists the granule names and contents. See 
Appendix A for more information regarding file naming conventions. 


Table B-1 ANC07 Granule Names and Contents 


Naming Convention 

Contents 

anc07_mmm_nn_0000.dat 

Error and Status sections 

anc07_mmm_nn_0001 .dat 

Global constants 

anc07_mmm_nn_0002.dat 

Atmosphere constants 

anc07_mmm_nn_0003.dat 

Elevation constants 

anc07_mmm_nn_0004.dat 

Waveform constants 

anc07_mmm_nn_0005.dat 

LI A constants 

anc07_mmm_nn_0006.dat 

Utility constants 


B.3 ANC07 Contents 


Global constants and those used by the LI A, Atmosphere, Elevation, and Waveforms are 
listed in this section. Error and Status messages are listed in Appendix D. Values listed here 
are current for the final release version of GSAS (6.0. 1). 

B.3.1 Global Constants 


# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 


< 0 

from ATM, WF, ELEV 


06/07/99 PLJ Corrected the elevation status messages 
1999 September 22 JLee, Updated GLAS_Error where error 
09/27/99 GMM Updated the error list to include entries 
subsystems and made error codes negative. 

Fixed error code . 

Integrated ATM constants 
Fixed error codes, split out. 

Included errors from GM email 
Updated 

Added DEM constants from Elevation 
PJester, Added GPS to UTC offset 

Modified GPS to UTC offset to match Donghui ' s data 
Moved calibration coefs from L1A to here so that 
both WF and L1A can use them 

Changed GPSttoUTCof f set to work with MOSS6 data. 
Modified GPS to UTC offset to match data 
Modified GPS to UTC offset (again) to match data 
CR20020412-001 Change energy calib coeffs 
added d_cnt 2 volt Table & d_cnt2gainTable 
moved d_dthires from const_lla_mod & const_wf_mod 
and renamed gd_dthires 

2003-07-28 JLee, CR0000480 instrument state sensitivity 

2003-11-05 LA Roberts, changed D_CAL_C to GD_CAL_C, 

D_CAL_C_DET I D to GD_CAL_C_DETID , D_CAL_C_DIGID to GD_CAL_C_DIGID , 


1999 

October 

18 

JLee , 

1999 

November 

01 

JLee , 

1999 

November 

09 

JLee , 

1999 

November 

10 

JLee, 

2000 

March 

13 

JLee , 

2001 

April 

13 

JLee, 

2001 

May 

16 

PJest 

2001 

June 

08 

JLee , 

2001 

August 

22 

JLee , 

2002 

January 

24 

JLee , 

2002 

January 

08 

JLee , 

2002 

April 

11 

JLee , 

2002 

April 

23 

Jlee , 

2002- 

-12-06 LA 

Roberts , 

2003- 

-06-17 LA 

Roberts , 
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# 

# 

# 

# 

# 

# 

# 

# 

# 

# 


added GD_CO_FIBER_BOX 

2005-04-06 LA Roberts, updated energy calculation variables 
2005-05-12 LA Roberts, set GD_THRN S I GR to 2 . OdO 
2005-05-16 LA Roberts, added gd_minRANrg & gd_minRlNrg 

2005- 07-21 LA Roberts, set GD_THRN S I GR to 4 . 5d0 

2006- 04-12 JLee, CR2240 xmit energy gain fix 

2008-01-07 LA Roberts, moved anc52 saturation parameters from const_elev_mod 


Constants Mod Entries 


BEG_OF_GLOBALS = 

GLOB_VERS = ANC07 Globals V6 . 0 . 1 2011-05-16 

# 

# Minimum Number of ANC32 records 

# 


GI_MIN_ANC32_RECS=2 

# 

# Mean Ellipsiod Radius 

# 

ELLIPAE = 6378136. 3d0 


# 

# Ellipsiod Flattening 

# 

ELLIPF = 298 . 257d0 


# 

# min GLA05%i_satNdx for filling d_satRngCorr , d_satNrgCorr or d_satPwdCorr 
GI_MIN_SATNDX = 2 

# 

# Gain Correction Factor is used to correct the computed transmit energy by the 

# transmitted gain (in counts) and is calculated by the laser dependent 

# coefficients GD_GAINCOEFF . 

# 

GD_GAINCOEFF_l=l . OdO , O.OdO, O.OdO, 0 . OdO 

GD_GAINCOEFF_2=l . 0746249D00, -2 . 2 66 5 95 9D- 03 , 1 . 193 9701D- 05 , - 2 . 56 164 17D- 0 8 
GD_GAINCOEFF_3=1.096532D00, -3 . 0427996D- 03 , 1 . 8456647D- 05 , -4 . 0 66 6 97 9D- 08 

# 

# Tables for converting raw WF counts to volts 

# d_wf_volts = d_cnt2voltTable (i_wf_counts) 

# 

# The following was used to generate this table: 

# f = al*y+bl for 0<=y<=127 

# a2*y+b2 for 127<y<=255 

# f ==d_cnt2voltTable , y==i_wf_counts 

# detector 1 

# al==0 . 006675, bl==-0. 19528 

# a2==0 . 006198, b2==-0. 13442 

# detector 2 

# al==0 . 006625, bl==-0. 19383 

# a2==0 . 006128, b2==-0. 13044 

# 

D_CNT2V0LTTABLE1_1 = - 0.19527 9d0 , -0.188604d0, -0.181929d0, -0.175254d0, - 
0 . 168579d0 , -0.161904d0, -0.155229d0, -0.148554d0, -0.141879d0, -0.135204d0, - 

0 . 128529d0 , -0.121854d0, -0.115179d0, -0.108504d0, -0.101829d0, -0.095154d0 

D_CNT2V0LTTABLE1_2 = - 0.08847 9d0 , -0.081804d0, -0.075129d0, -0.068454d0, - 
0 . 061779d0 , - 0 . 0 55104d0 , -0.048429d0, -0.041754d0, -0.035079d0, -0.028404d0, - 

0 . 021729d0 , - 0 . 015054d0 , -0.008379d0, -0.001704d0, 0.004971d0, 0.011646d0 

D_CNT2VOLTTABLE1_3=0 . 018321d0 , 0.024996d0, 0.031671d0, 0.038346d0, 0.045021d0, 

0 . 0516 96d0 , 0 . 058371d0 , 0.065046d0, 0.071721d0, 0.078396d0, 0.085071d0, 

0 . 091746d0 , 0 . 098421d0 , 0.105096d0, 0.111771d0, 0.118446d0 
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D_CNT2VOLTTABLE1_4=0 . 125121d0, 0.131796d0, 0.138471d0, 0.145146d0, 0.151821d0, 

0 . 1584 96d0 , 0 . 165171d0 , 0.171846d0, 0.178521d0, 0.185196d0, 0.191871d0, 

0 . 198546d0 , 0 . 205221d0 , 0.211896d0, 0.218571d0, 0.225246d0 

D_CNT2VOLTTABLE1_5=0 ,231921d0, 0.238596d0, 0.245271d0, 0.251946d0, 0.258621d0, 

0 . 2 652 96d0 , 0.271971d0, 0.278646d0, 0.285321d0, 0.291996d0, 0.298671d0, 

0 . 305346d0 , 0.312021d0, 0.318696d0, 0.325371d0, 0.332046d0 

D_CNT2VOLTTABLE1_6=0 ,338721d0, 0.345396d0, 0.352071d0, 0.358746d0, 0.365421d0, 

0 . 372096d0 , 0.378771d0, 0.385446d0, 0.392121d0, 0.398796d0, 0.405471d0, 

0 . 4 12 14 6d0 , 0 . 418821d0 , 0.425496d0, 0.432171d0, 0.438846d0 

D_CNT2VOLTTABLE1_7=0 ,445521d0, 0.452196d0, 0.458871d0, 0.465546d0, 0.472221d0, 

0.478 8 96d0 , 0.485571d0, 0.492246d0, 0.498921d0, 0.505596d0, 0.512271d0, 

0 . 518946d0 , 0.525621d0, 0.532296d0, 0.538971d0, 0.545646d0 

D_CNT2VOLTTABLE1_8=0. 55232 ldo, 0.558996d0, 0.565671d0, 0.572346d0, 0.579021d0, 

0.585696d0, 0.592371d0, 0.599046d0, 0.605721d0, 0.612396d0, 0.619071d0, 

0 . 625746d0 , 0.632421d0, 0.639096d0, 0.645771d0, 0.652446d0 

D_CNT2VOLTTABLE1_9=0 . 658924d0, 0.665122d0, 0.67132d0, 0.677518d0, 0.683716d0, 

0 . 6 8 9914d0 , 0 . 696112d0 , 0.70231d0, 0.708508d0, 0.714706d0, 0.720904d0, 
0.727102d0, 0 . 7333d0 , 0.739498d0, 0.745696d0, 0.751894d0 

D_CNT2VOLTTABLE1_10 = 0 .75 8 0 92d0 , 0.76429d0, 0.770488d0, 0.776686d0, 0.782884d0, 

0 . 78 9082d0 , 0.79528d0, 0.801478d0, 0.807676d0, 0.813874d0, 0.820072d0, 0.82627d0, 
0 . 832468d0 , 0.838666d0, 0.844864d0, 0.851062d0 

D_CNT2VOLTTABLE1_11=0 . 85726d0, 0.863458d0, 0.869656d0, 0.875854d0, 0.882052d0, 

0 . 88825d0 , 0.894448d0, 0.900646d0, 0.906844d0, 0.913042d0, 0.91924d0, 0.925438d0, 
0 . 93163 6d0 , 0.937834d0, 0.944032d0, 0.95023d0 

D_CNT2VOLTTABLE1_12=0 . 956428d0 , 0.962626d0, 0.968824d0, 0.975022d0, 0.98122d0, 

0 . 987418d0 , 0 . 993616d0 , 0.999814d0, 1.006012d0, 1.01221d0, 1.018408d0, 

1.0246 0 6d0 , 1 . 030804d0 , 1.037002d0, 1.0432d0, 1.049398d0 

D_CNT2VOLTTABLEl_13=1.055596d0, 1.061794d0, 1.067992d0, 1.07419d0, 1.080388d0, 

1 . 086586d0 , 1 . 092784d0 , 1.098982d0, 1.10518d0, 1.111378d0, 1.117576d0, 

1 . 12 3 774d0 , 1.129972d0, 1.13617d0, 1.142368d0, 1.148566d0 

D_CNT2V0LTTABLE1_14 = 1 . 154 7 64d0 , 1.160962d0, 1.16716d0, 1.173358d0, 1.179556d0, 

1 . 185754d0 , 1 . 191952d0 , 1.19815d0, 1.204348d0, 1.210546d0, 1.216744d0, 
1.222942d0, 1 . 22914d0 , 1.235338d0, 1.241536d0, 1.247734d0 

D_CNT2VOLTTABLEl_15=1.253932dO, 1.26013d0, 1.266328d0, 1.272526d0, 1.278724d0, 

1.284922d0, 1 . 2 9112d0 , 1.297318d0, 1.303516d0, 1.309714d0, 1.315912d0, 1.32211d0, 
1 . 32 83 0 8d0 , 1 . 334506d0 , 1.340704d0, 1.346902d0 

D_CNT2V0LTTABLE1_16=1 . 3531d0 , 1.359298d0, 1.365496d0, 1.371694d0, 1.377892d0, 

1 . 38409d0 , 1 . 390288d0 , 1.396486d0, 1.402684d0, 1.408882d0, 1.41508d0, 1.421278d0, 
1 . 42 74 7 6d0 , 1 . 433674d0 , 1 . 4 3 9872d0 , 1 . 44 6 0 7d0 

D_CNT2V0LTTABLE2_1 = - 0 . 1 93 82 8d0 , -0.187203d0, -0.180578d0, -0.173953d0, - 
0 . 167328d0 , -0.160703d0, -0.154078d0, -0.147453d0, -0.140828d0, -0.134203d0, - 

0 . 127578d0 , - 0 . 12 0 953d0 , -0.114328d0, -0.107703d0, -0.101078d0, -0.094453d0 

D_CNT2V0LTTABLE2_2=- 0 . 08 782 8d0 , -0.081203d0, -0.074578d0, -0.067953d0, - 
0 . 061328d0 , - 0 . 0 54 7 03d0 , -0.048078d0, -0.041453d0, -0.034828d0, -0.028203d0, - 

0 . 021578d0 , - 0 . 0 14 953d0 , -0.008328d0, -0.001703d0, 0.004922d0, 0.011547d0 

D_CNT2VOLTTABLE2_3=0 . 018172d0, 0.024797d0, 0.031422d0, 0.038047d0, 0.044672d0, 

0 . 0512 97d0 , 0 . 057922d0 , 0.064547d0, 0.071172d0, 0.077797d0, 0.084422d0, 

0 . 091047d0 , 0 . 097672d0 , 0.104297d0, 0.110922d0, 0.117547d0 

D_CNT2VOLTTABLE2_4=0.124172d0, 0.130797d0, 0.137422d0, 0.144047d0, 0.150672d0, 

0 . 1572 97d0 , 0.163922d0, 0.170547d0, 0.177172d0, 0.183797d0, 0.190422d0, 

0 . 197 04 7d0 , 0 . 203672d0 , 0.210297d0, 0.216922d0, 0.223547d0 

D_CNT2VOLTTABLE2_5=0 ,230172d0, 0.236797d0, 0.243422d0, 0.250047d0, 0.256672d0, 

0 . 2 63 2 97d0 , 0.269922d0, 0.276547d0, 0.283172d0, 0.289797d0, 0.296422d0, 

0 . 3 03 04 7d0 , 0.309672d0, 0.316297d0, 0.322922d0, 0.329547d0 

D_CNT2VOLTTABLE2_6=0 . 336172d0 , 0.342797d0, 0.349422d0, 0.356047d0, 0.362672d0, 

0 . 3692 97d0 , 0.375922d0, 0.382547d0, 0.389172d0, 0.395797d0, 0.402422d0, 

0 . 409047d0 , 0 . 415672d0 , 0.422297d0, 0.428922d0, 0.435547d0 

D_CNT2VOLTTABLE2_7=0 . 442172d0 , 0.448797d0, 0.455422d0, 0.462047d0, 0.468672d0, 

0 . 4 752 97d0 , 0.481922d0, 0.488547d0, 0.495172d0, 0.501797d0, 0.508422d0, 
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0 . 515047d0 , 0 . 521672d0 , 0.528297d0, 0.534922d0, 0.541547d0 

D_CNT2VOLTTABLE2_8=0.548172dO, 0.554797d0, 0.561422d0, 0.568047d0, 0.574672d0, 

0 . 5812 97d0 , 0.587922d0, 0.594547d0, 0.601172d0, 0.607797d0, 0.614422d0, 

0 . 621047d0 , 0 . 627672d0 , 0.634297d0, 0.640922d0, 0.647547d0 

D_CNT2VOLTTABLE2_9=0.653941d0, 0.660069d0, 0.666197d0, 0.672325d0, 0.678453d0, 

0 . 684581d0 , 0 . 690709d0 , 0.696837d0, 0.702965d0, 0.709093d0, 0.715221d0, 

0 . 721349d0 , 0.727477d0, 0.733605d0, 0.739733d0, 0.745861d0 

D_CNT2VOLTTABLE2_10 = 0 . 7 5 1 98 9d0 , 0.758117d0, 0.764245d0, 0.770373d0, 0.776501d0, 
0 . 782629d0 , 0.788757d0, 0.794885d0, 0.801013d0, 0.807141d0, 0.813269d0, 

0 . 819397d0 , 0.825525d0, 0.831653d0, 0.837781d0, 0.843909d0 

D_CNT2VOLTTABLE2_ll=0.850037d0, 0.856165d0, 0.862293d0, 0.868421d0, 0.874549d0, 
0 . 88 0677d0 , 0.886805d0, 0.892933d0, 0.899061d0, 0.905189d0, 0.911317d0, 

0 . 917445d0 , 0 . 923573d0 , 0.929701d0, 0.935829d0, 0.941957d0 

D_CNT2VOLTTABLE2_12 = 0 .9480 8 5d0 , 0.954213d0, 0.960341d0, 0.966469d0, 0.972597d0, 
0 . 978725d0 , 0.984853d0, 0.990981d0, 0.997109d0, 1.003237d0, 1.009365d0, 

1 . 0154 93d0 , 1 . 021621d0 , 1.027749d0, 1.033877d0, 1.040005d0 

D_CNT2VOLTTABLE2_13=l . 046133d0 , 1.052261d0, 1.058389d0, 1.064517d0, 1.070645d0, 
1 . 076773d0 , 1.082901d0, 1.089029d0, 1.095157d0, 1.101285d0, 1.107413d0, 

1 . 113541d0 , 1 . 119669d0 , 1.125797d0, 1.131925d0, 1.138053d0 

D_CNT2VOLTTABLE2_14=l . 144181d0 , 1.150309d0, 1.156437d0, 1.162565d0, 1.168693d0, 
1 . 174821d0 , 1.180949d0, 1.187077d0, 1.193205d0, 1.199333d0, 1.205461d0, 
1.211589d0, 1 . 217717d0 , 1.223845d0, 1.229973d0, 1.236101d0 

D_CNT2VOLTTABLE2_15 = l . 24222 9d0 , 1.248357d0, 1.254485d0, 1.260613d0, 1.266741d0, 
1.272869d0, 1 . 278997d0 , 1.285125d0, 1.291253d0, 1.297381d0, 1.303509d0, 

1 . 3 0 963 7d0 , 1.315765d0, 1.321893d0, 1.328021d0, 1.334149d0 

D_CNT2VOLTTABLE2_16=l . 340277d0 , 1.346405d0, 1.352533d0, 1.358661d0, 1.364789d0, 
1.370917d0, 1 . 3 77 04 5d0 , 1.383173d0, 1.389301d0, 1.395429d0, 1.401557d0, 

1 . 4 07 6 85d0 , 1 . 413 813d0 , 1.419941d0, 1.426069d0, 1.432197d0 

# 

# Gain Correction Table computed following Xiaoli ' s original algorithm 
using a "normalized" gain 


D_CNT2GAINTABLE_1=0 . OdO, 0 . 00392157d0 , 0 . 00784314d0 , 0 . 01176471d0 , 

0 . 01568627d0 , 0 . 01960784d0 , 0 . 02352941d0 , 0 . 02745098d0 , 0 . 03137255d0 , 

0 . 03 52 94 12d0 , 0 . 03 92 15 6 9d0 , 0 . 04313 725d0 , 0 . 04705882d0 , 0 . 05098039d0 , 

0 . 05490196d0 , 0.05882353d0 

D_CNT2GAINTABLE_2=0.0627451dO, 0 . 06666667d0 , 0 . 07058824d0 , 0.0745098d0, 

0 . 0784 3 13 7d0 , 0 . 08235294d0 , 0 . 08627451d0 , 0 . 09019608d0 , 0 . 09411765d0 , 

0 . 09803922d0 , 0 . 10196078d0 , 0 . 10588235d0 , 0 . 10980392d0 , 0 . 11372549d0 , 

0.117 64 7 0 6d0 , 0 . 12156863d0 

D_CNT2GAINTABLE_3=0.1254902d0, 0 . 12941176d0 , 0 . 13333333d0 , 0.1372549d0, 

0 . 14 117 64 7d0 , 0 . 14509804d0 , 0 . 14901961d0 , 0 . 152 94 11 8d0 , 0 . 15686275d0 , 

0 . 16078431d0 , 0 . 16470588d0 , 0 . 16862745d0 , 0 . 17254902d0 , 0 . 17647059d0 , 

0 . 18039216d0 , 0 . 18431373d0 

D_CNT2GAINTABLE_4 = 0 . 18 823 52 9d0 , 0 . 19215686d0 , 0 . 19607843d0 , 0.2d0, 

0 . 2 03 92 15 7d0 , 0 . 2 0 7 84 3 14d0 , 0 . 21176471d0 , 0 . 21568627d0 , 0 . 21960784d0 , 

0 . 22352941d0 , 0 . 22745098d0 , 0 . 23137255d0 , 0 . 2 3 52 94 12d0 , 0 . 23 92 156 9d0 , 

0 . 24 3 13 725d0 , 0.24705882d0 

D_CNT2GAINTABLE_5 = 0 . 2 5 0 98 03 9d0 , 0 . 2 54 90196d0 , 0 . 25882353d0 , 0.2627451d0, 

0 . 26666667d0 , 0 . 27058824d0 , 0.2745098d0, 0 . 27843137d0 , 0 . 28235294d0 , 

0 . 28627451d0 , 0 . 2 90196 08d0 , 0 . 29411765d0 , 0 . 29803922d0 , 0 . 30196078d0 , 

0 . 30588235d0 , 0.30980392d0 

D_CNT2GAINTABLE_6 = 0 . 3 13 72 54 9d0 , 0 . 31764706d0 , 0 . 32 156 8 63d0 , 0.3254902d0, 

0 . 32 94 117 6d0 , 0 . 33333333d0 , 0.3372549d0, 0 . 34117647d0 , 0 . 34509804d0 , 

0 . 34901961d0 , 0 . 3 52 94 118d0 , 0 . 35686275d0 , 0 . 36078431d0 , 0 . 36470588d0 , 

0 . 36862745d0 , 0.37254902d0 

D_CNT2GAINTABLE_7 = 0 . 3 7 64 7 05 9d0 , 0 . 3 8 03 92 16d0 , 0 . 38431373d0 , 0 . 3 8 823 52 9d0 , 

0 . 39215686d0 , 0 . 39607843d0 , 0.4d0, 0 . 4 03 92 157d0 , 0 . 40784314d0 , 0 . 41176471d0 , 


0 . 41568627d0 , 0 . 41960784d0 , 0 . 42352941d0 , 0 . 42 74 5 0 9 8d0 , 0 . 43137255d0 , 
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0 . 43 52 94 12d0 

D_CNT2GAINTABLE_8 = 0 .4392156 9d0 , 0 . 44313725d0 , 0 . 44705882d0 , 0 . 45098039d0 , 

0 . 45490196d0 , 0 . 45882353d0 , 0.4627451d0, 0 . 46666667d0 , 0 . 47058824d0 , 

0 . 4745098d0 , 0 . 47843137d0 , 0 . 48235294d0 , 0 . 4 8 62 74 5 ldO , 0 . 4 90 1 96 0 8d0 , 

0 . 49411765d0 , 0.49803922d0 

D_CNT2GAINTABLE_9 = 0 .501960 78d0 , 0 . 50588235d0 , 0 . 50 98 03 92d0 , 0 . 51372549d0 , 

0 . 51764706d0 , 0 . 52156863d0 , 0.5254902d0, 0 . 52941176d0 , 0 . 53333333d0 , 

0.537 2 54 9d0 , 0 . 54117647d0 , 0 . 54509804d0 , 0 . 54901961d0 , 0 . 55294118d0 , 

0 . 55686275d0 , 0.56078431d0 

D_CNT2GAINTABLE_10=0.56470588d0, 0 . 56862745d0 , 0 . 57254902d0 , 0 . 57647059d0 , 

0 . 58039216d0 , 0 . 58431373d0 , 0 . 58823529d0 , 0 . 59215686d0 , 0 . 59607843d0 , 0.6d0, 

0 . 60392157d0 , 0 . 60784314d0 , 0 . 61176471d0 , 0 . 61568627d0 , 0 . 61960784d0 , 

0 . 62352941d0 

D_CNT2GAINTABLE_ll=0.62745098d0, 0 . 63 13 7255d0 , 0 . 63 52 94 12d0 , 0 . 63 92 156 9d0 , 

0 . 64 3 13 725d0 , 0 . 64705882d0 , 0 . 6509803 9d0 , 0 . 65490196d0 , 0 . 65882353d0 , 

0 . 6627451d0 , 0 . 66666667d0 , 0 . 67058824d0 , 0.6745098d0, 0 . 67843137d0 , 

0 . 68235294d0 , 0.68627451d0 

D_CNT2GAINTABLE_12=0.69019608d0, 0 . 69411765d0 , 0 . 6 9 8 03 922d0 , 0 . 70196078d0 , 

0 . 70588235d0 , 0 . 70980392d0 , 0 . 71372549d0 , 0 . 71764706d0 , 0 . 72156863d0 , 

0 . 72 54 902d0 , 0 . 72941176d0 , 0 . 73333333d0 , 0.7372549d0, 0 . 74117647d0 , 

0.745 0 98 04d0 , 0.74901961d0 

D_CNT2GAINTABLE_13=0.75294118d0, 0 . 75686275d0 , 0 . 76 0 784 3 ldO , 0 . 76470588d0 , 

0 . 76862745d0 , 0 . 77254902d0 , 0 . 77647059d0 , 0 . 78039216d0 , 0 . 78431373d0 , 

0 . 78823529d0 , 0 . 79215686d0 , 0 . 79607843d0 , 0.8d0, 0 . 80392157d0 , 0 . 807843 14d0 , 

0 . 81176471d0 

D_CNT2GAINTABLE_14=0.81568627d0, 0 . 81960784d0 , 0 . 82352941d0 , 0 . 82745098d0 , 

0 . 83137255d0 , 0 . 83529412d0 , 0 . 83 921569d0 , 0 . 84313725d0 , 0 . 84705882d0 , 

0 . 85098039d0 , 0 . 85490196d0 , 0 . 85882353d0 , 0.8627451d0, 0 . 86666667d0 , 

0 . 87058824d0 , 0.8745098d0 

D_CNT2GAINTABLE_15=0.87843137d0, 0 . 88235294d0 , 0 . 88627451d0 , 0 . 89019608d0 , 

0 . 89411765d0 , 0 . 89803922d0 , 0 . 90196078d0 , 0 . 90588235d0 , 0 . 90980392d0 , 

0 . 91372549d0 , 0 . 91764706d0 , 0 . 92156863d0 , 0.9254902d0, 0 . 92941176d0 , 

0 . 93333333d0 , 0.9372549d0 

D_CNT2GAINTABLE_16=0 . 94117647d0, 0 . 94509804d0 , 0 . 94 90196 ldO , 0 . 952 94 118d0 , 

0 . 95686275d0 , 0 . 96078431d0 , 0 . 96470588d0 , 0 . 96862745d0 , 0 . 97254902d0 , 

0 . 9764 7 05 9d0 , 0 . 9 8 03 92 16d0 , 0 . 98431373d0 , 0 . 98823529d0 , 0 . 99215686d0 , 

0 . 99607843d0 , 1 . OdO 

# 

# Calibration Coefficients 

# cal_tx = ( GD_CAL_TX_C_FB * GD_CAL_C_DETID * GD_CAL_C_DIGID) * 

# (GD_CAL_C (1) +GD_CAL_C (2) *T_detID +GD_CAL_C (3) *T_detID^2) * 

# (GD_CAL_C (4) +GD_CAL_C (5) *T_digID +GD_CAL_C (6) *T_digID^2) * 

# ( GD_CAL_C ( 7 ) +GD_CAL_C ( 8 ) *T_relay +GD_CAL_C ( 9 ) *T_relay^2 ) * 

# (GD_CAL_C (10) +GD_CAL_C (11) *T_fb +GD_CAL_C ( 12 ) *T_f b A 2 +GD_CAL_C ( 13 ) *T_fb^3 ) 

# 

# cal_rec = (GD_CAL_C_DETID * GD_CAL_C_DIGID) * 

# (GD_CAL_C (1) +GD_CAL_C (2) *T_detID +GD_CAL_C (3) *T_detID^2) * 

# (GD_CAL_C (4) +GD_CAL_C (5) *T_digID +GD_CAL_C (6) *T_digID^2) * 

# ( GD_CAL_C ( 7 ) +GD_CAL_C ( 8 ) *T_relay +GD_CAL_C ( 9 ) *T_relay^2 ) 

# 

# With these values for GD_CAL_C, temps will not affect above values 
GD_CAL_C = 

1 . OdO, 0 . OdO, 0 . OdO, 1 . OdO, 0 . OdO, 0 . OdO, 1 . OdO, 0 . OdO, 0 . OdO, 1 . OdO, 0 . OdO, 0 . OdO, 0 . OdO 

# 

# 

# detector=l, laser=l, 2, 3 

#GD_CO_FIBER_BOX1 ( 1 : 3 ) =2 . 96 5e- 14/2 . 86e - 14 , 2 . 7 8 6e- 14/2 . 8 6e - 14 , 2 . 7 93e- 14 /2 . 8 6e - 14 
#GD_CO_FIBER_BOX1 = 1.036713287,0.974125874,0.976573426 mantis 1750 LAR050406 

GD_C 0 _F ! B E R_ B °X 1 = 1 . 12d0 , 1 . 12d0 , 1 . 12d0 
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# 

# Values are same for detector 2 until sci team gives update 

# detector=2, laser=l, 2, 3 

#GD_CO_FIBER_BOX2 ( 1 : 3 ) =2 . 96 5e- 14/2 . 86e - 14 , 2 . 7 8 6e- 14/2 . 8 6e - 14 , 2 . 7 93e- 14 /2 . 8 6e - 14 
#GD_CO_FIBER_BOX2 = 1.036713287,0.974125874,0.976573426 mantis 1750 LAR050406 

G D _C°_FIBE R _ B0 X2 = 1 . 12d0, 1 . 12d0, 1 . 12d0 

# 

# Values are same for detector 2 until sci team gives update 

# for detectors 1 & 2 

#GD_CAL_C 0_DET I D = 1 . 2 ldO , 1 . 2 ldO ... changed, mantis 1750 LAR050406 

GD_CAL_C 0 _D E T I D = 1 . OdO , 1 . OdO 

# 

# Values are same for digitizer 2 until sci team gives update 

# for digitizers 1 & 2 
GD_CAL_C 0 _D I G I D = 1 . OdO , 1 . OdO 

# 

# 

GD _N_F°V = 1 . OdO 
GD_N_C];RC = 0 . 923d0 
GD_R_ D ET = 2 . 28d7 
# 

# detector=l, laser=l, 2, 3 

GD_N_° P T_RE CO! = 0 . 670d0 , 0 . 670d0 , 0 . 670d0 

# 

# Values are same for detector 2 until sci team gives update 

# detector=2, laser=l, 2, 3 

GD _N_0 P T_RE C 0 2 = 0 . 670d0, 0 . 670d0, 0 . 670d0 

# 

# detector=l, laser=l, 2, 3 

GD_N_ 0 P T _TX° 1 = 2.9650d-14,2.7868d-14,2.7937d-14 

# 

# (laser=l,detector=2 should not happen) 

# detector=2, laser=l, 2, 3 

GD_N_° P T_TX 0 2 = 2 . 965 Od- 14 , 2 . 2 572d- 14 , 2 . 3 3 5 7d- 14 

# 

# delta lat for DEM grid 

# 

DEMdLat = 0 . 00833333333333d0 

# 

# delta Ion for DEM grid 

# 

DEMdLon = 0 . 00833333333333d0 

# 

# Start latitude on the DEM grid 

# 

DEMLAT_B EG = 90 . 00416666666667d0 

# 

# Start longitude on the DEM grid 

# 

DEMLON_BEG = - 0 . 0 04 16 6 6 66 6 66 67d0 

# 

# The offset from the GPS reference time (00:00 Jan 1, 1980) 

# to the UTC reference time (12:00 Jan 1, 2000) 

# 

GPStoUTCof f set = -630763200.00000 

# 

# Max PAD offset allowed (max off-nadir pointing angle) 

# 

MAXPADOFF = 0 . 5d0 
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# 

# 1064 Basic time interval - nominally 1 ns 

# 

gd_dthires = 1 . OdO 

# 

# Threshold for computing the transmit energy from trans pulse peak 

# 

GD_THRPCNT = 0.03d0 

# 

# Threshold for computing the received energy from rec waveform peak 

# = noise + GD_THRN S I GR * stdDevNoise 

# 

GD_THRN S I GR = 4 . 5d0 

# 

# Minimum energy - if E is less than this, then it will be stored as 0 

# on glaOl. These numbers should be updated if the scale is changed 

# for either i_RecNrgAll_EU, or i_RecNrgLast_EU 

# 

gd_minRANrg = 0.5d-18 
gd_jninRlNrg = 0.5d-18 
# 

# Icesat/NOSE track offset 

# 

GI_N0SE_TRACK_0FFSET=2842 

# 

END_OF_GLOBALS = 

# 

END_OF_ANC07_FILE = 

B.3.2 L1A Constants 

# 

# lla Constants Mod Entries 

# 

BEG_0F_L1A = 

L1A_VERS = ANC07 Lla V6 . 0 2010-11-03 

# 

# 1064 transmit energy default to use when computed energy is unavailable 

# 

GD_IR_TXNRG = 70.0D-3 

# 

# 532 / 1064 Lower energy threshold (Joules) 

# 

GD_NRG_THR1 = 0.5D-3 

# 

# 532 / 1064 Upper energy threshold (Joules) 

# 

GD_NRG_THR2 = 100.0D-3 

# 

# 532 energy mJ per count 

# 

GD_G_NRG_MJ_CT = 0.25d0 

# 

# Default value for range from satellite to 532 profile (m) 

# 

GD_RNG2PCPROF = 5 . 6d5 

# 

# Lower threshold for range from satellite to 532 profile (m) 

# 
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GD_RNG2PCPROFl = 5 . 0d5 

# 

# Upper threshold for range from satellite to 532 profile (m) 

# 

GD_RNG2PCPROF2 = 6.2d5 

# 

# ground ret threshold 

# 

GI_GRND_THRESH =20 

# 

# cloud ret threshold 

# 

GI_CLD_THRESH = 5 

# 

#lidar bin sat val 

# 

GI_LID_SATVAL = 8 

# 

# quality flag(lhz) for integrated return 

# 

GI_INT_QFVAL= 800,600,400,100 

# 

# 532 laser energy max value 

# 

G I _G_NRGMAX =36 

# 

# 1064 laser energy max value 

# 

GI_IR_NRGMAX = 73 

# 

#background index used for 532/1064 

#l=upper, 2=lower, 3= (upper+lower ) /2 , 4=avg of last 8 bins of the profile 

# 

GI_G_USEDBG = 1 

# 

# background index used for 532/1064 

# 

GI_IR_USEDBG = 3 

# 

# Droop flag 

# 

GI_C0RRECT_DR00P=1 

# 

# GainShift Constants 

# 

GI_LIM_GAINSHI FT_RNG=4 5 0 0 0 0 0 
GD_LIM_GAINSHIFT_SEC= 0 . 03d0 
# 

# GLA04 time latencies 

# 

GD_GYRO_T I ME_LAT = -0.048237d0 
GD_BST1_TIME_LAT = 0 . 0D0 
GD_B S T 2 _T I ME_LAT = 0 . 0D0 
GD_LRS_TIME_LAT = 0.03274d0 
GD_I S T_T I ME_LAT = 0.032168d0 
GD_POS_ATT_TIME_LAT = 0.0000015DO 
# 

# GLA04 LRS VT Subject Swap Parameters 

# 
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# X=C, Y=R 

# 

GD_LIM_VT1CENTR = 850. OdO 920. OdO 
GD_LIM_VT1CENTC = 850. OdO 900. OdO 
GD_LIM_VT2CENTR = 930. OdO 975. OdO 
GD_LIM_VT2CENTC = 1175 . OdO 1215. OdO 
GD_VAL_VT1CENTR = 830. OdO 950. OdO 
GD_VAL_VT1CENTC = 820. OdO 950. OdO 
GD_VAL_VT2 CENTR = 900. OdO 1060. OdO 
GD_VAL_VT2 CENTC = 1100. dO 1260. OdO 
GD_L I M_VT 1 NRG = 1500. OdO 
GD_L I M_VT 2 NRG = 75. OdO 
GD_L I M_VTC_RATE = 8 . OdO 
GD_L I M_VTR_RATE = 8 . OdO 
GD_LIM_VT_SWAP_T = 2 . OdO 
# 

# GLA04 COI Limit 

# 

GD_IST_COI_LIM = 0.14 OdO 

# 

# deadtime correction lookup table - allows for up to 255 entries in the table 

# note : each keyword value can not exceed 255 characters therefore value 

# distributed between several keywords . 

# 

# DTC for SPCM1 

# 

D_ DT C_TBL1_ 1 =9 . 796iD- Oi , 1.0206D+00, 9.8440D-01, 1.0053D+00, 1.0012D+00, 9.9708D- 
01, 1 . 0035D+00 , 1 . 0099D+00 , 1.0174D+00, 1.0249D+00, 1.0323D+00, 1.0398D+00, 

1 . 0433D+00 , 1 . 0469D+00 , 1.0504D+00, 1.0540D+00, 1.0575D+00, 1.0611D+00, 

1 . 0674D+00 , 1 . 0737D+00 

D_ DT C_ TBL2 _ 1 = 1 .080 0D+ 0 0 , 1 . 0863D+00 , 1.0926D+00, 1.0989D+00, 1.1052D+00, 

1 . 1115D+00 , 1 . 1178D+00 , 1.1237D+00, 1.1297D+00, 1.1356D+00, 1.1415D+00, 

1.14 7 5D+ 0 0 , 1 . 1534D+00 , 1.1593D+00, 1.1653D+00, 1.1712D+00, 1.1772D+00, 

1.18 3 1D+ 0 0 , 1 . 1890D+00 , 1.1946D+00 

D_ D TC_TBL3_1 = 1 . 2 0 02D+ 0 0 , 1.2057D+00, 1.2113D+00, 1.2169D+00, 1.2224D+00, 

1 . 2280D+00 , 1 . 2336D+00 , 1.2391D+00, 1.2447D+00, 1.2502D+00, 1.2558D+00, 

1 . 2614D+00 , 1 . 2669D+00 , 1.2725D+00, 1.2781D+00, 1.2836D+00, 1.2892D+00, 

1.286 7D+ 0 0 , 1.2843D+00, 1.2818D+00 

D_DTC_TBL4_ 1 = 1 . 2794D+00 , 1.2769D+00, 1.2744D+00, 1.2720D+00, 1.2695D+00, 

1 . 2671D+00 , 1 . 2646D+00 , 1.2621D+00, 1.2597D+00, 1.2572D+00, 1.2547D+00, 

1 . 2523D+00 , 1 . 2498D+00 , 1.2482D+00, 1.2465D+00, 1.2449D+00, 1.2433D+00, 

1.2416D+00, 1 . 2400D+00 , 1.2383D+00 

D_DTC_TBL5_ 1 = 1 . 2367D+00 , 1.2350D+00, 1.2334D+00, 1.2318D+00, 1.2301D+00, 

1 . 2285D+00 , 1.226 8D+0 0 , 1.2252D+00, 1.2235D+00, 1.2219D+00, 1.2203D+00, 

1 . 2186D+00 , 1.2170D+00, 1.2153D+00, 1.2211D+00, 1.2268D+00, 1.2325D+00, 

1 . 2383D+00 , 1.2440D+00, 1.2498D+00 

D_E)TC_TBL6_ 1 = 1 . 2555D+00 , 1.2612D+00, 1.2670D+00, 1.2727D+00, 1.2784D+00, 

1 . 2842D+00 , 1.289 9D+0 0 , 1.2957D+00, 1.3014D+00, 1.3071D+00, 1.3218D+00, 

1 . 3365D+00 , 1 . 3511D+00 , 1.3658D+00, 1.3805D+00, 1.3952D+00, 1.4098D+00, 

1 . 4245D+00 , 1 . 4392D+00 , 1.4538D+00 

D_ D TC_TB L7 _ 1 = 1 .468 5D+ 0 0 , 1.4832D+00, 1.5123D+00, 1.5414D+00, 1.5705D+00, 

1 . 5996D+00 , 1 . 6287D+00 , 1.6578D+00, 1.6869D+00, 1.7160D+00, 1.7451D+00, 

1 . 7935D+00 , 1.8420D+00, 1.8905D+00, 1.9389D+00, 1.9874D+00, 2.0359D+00, 

2 . 0843D+00 , 2 . 1560D+00 , 2.2276D+00 

D_ D TC_TBL8_ 1 =2 . 2 9 92D+ 0 0 , 2.3709D+00, 2.4425D+00, 2.5141D+00, 2.6235D+00, 

2 . 7328D+00 , 2.8421D+00, 2.9514D+00, 3.0607D+00, 3.2340D+00, 3.4073D+00, 

3 . 58 06D+0 0 , 3.7539D+00, 4.0480D+00, 4.3420D+00, 4.6361D+00, 5.1977D+00, 

5 . 7593D+00 , 7.1899D+00, 7.1899D+00 

D _ D TC_TBL9_ 1 =7 . !899D+00 , 7.1899D+00, 7.1899D+00, 7.1899D+00, 7.1899D+00, 
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7.1899D+00, 7 . 1899D+00 , 7.1899D+00, 7.1899D+00, 7.1899D+00, 7.1899D+00, 

7.1899D+00, 7 . 1899D+00 , 7.1899D+00, 7.1899D+00, 7.1899D+00, 7.1899D+00, 

7.1899D+00, 7 . 1899D+00 , 7.1899D+00 

D _ DTC _ TBL10 _ 1=7 - 18990+00 / 7 . 1899D+00 , 7.1899D+00, 7.1899D+00, 7.1899D+00, 
7.1899D+00, 7 . 1899D+00 , 7.1899D+00, 7.1899D+00, 7.1899D+00, 7.1899D+00, 

7.1899D+00, 7 . 1899D+00 , 7.1899D+00, 7.1899D+00, 7.1899D+00, 7.1899D+00, 

7.1899D+00, 7 . 1899D+00 , 7.1899D+00 

# 

# DCT for SPCM 2 

# 

°_ OTC _ TBL1 _ 2=1 • 01280+00 / 1 . 0422D+00 , 1 . 0427D+00 , 1.0400D+00, 1.0478D+00, 

1 . 0555D+00 , 1 . 0680D+00 , 1.0805D+00, 1.0851D+00, 1.0898D+00, 1.0944D+00, 

1.0991D+00, 1.1052D+00, 1.1113D+00, 1.1174D+00, 1.1236D+00, 1.1297D+00, 

1.1358D+00, 1.1423D+00, 1.1487D+00 

°_ OTC _ TBL2 _ 2 = 1 • 15510+00 - 1 . 1615D+00 , 1.16 8 0D+0 0 , 1.1744D+00, 1.1808D+00, 

1 . 1873D+00 , 1.1937D+00, 1.2014D+00, 1.2091D+00, 1.2168D+00, 1.2245D+00, 

1 . 2321D+00 , 1 . 2398D+00 , 1.2475D+00, 1.2552D+00, 1.2629D+00, 1.2706D+00, 

1 . 2783D+00 , 1.286 0D+0 0 , 1.2955D+00 

°_ OTC _ TBL3 _ 2=1 • 30510+00 < 1.3147D+00, 1 . 3242D+00 , 1.3338D+00, 1.3433D+00, 

1 . 3529D+00 , 1 . 3625D+00 , 1.3720D+00, 1.3816D+00, 1.3912D+00, 1.4007D+00, 

1 . 4103D+00 , 1 . 4199D+00 , 1.4294D+00, 1.4390D+00, 1.4462D+00, 1.4534D+00, 

1.4606D+00, 1 . 4678D+00 , 1.4750D+00 

°_ OTC _ TBL4 „ 2=1 - 48220+00 / 1 . 4894D+00 , 1 . 4966D+00 , 1.5039D+00, 1.5111D+00, 

1 . 5183D+00 , 1.5313D+00, 1.5444D+00, 1.5575D+00, 1.5706D+00, 1.5836D+00, 

1 . 5967D+00 , 1 . 6098D+00 , 1.6229D+00, 1.6359D+00, 1.6490D+00, 1.6641D+00, 

1 . 6 793D+ 0 0 , 1 . 6944D+00 , 1.7096D+00 

°_ OTC _ TBL5 _ 2 = 1 • 72470+00 < 1 - 7399D+00 , 1 . 7550D+00 , 1.7701D+00, 1.7853D+00, 
1.8004D+00, 1 . 8156D+00 , 1.8296D+00, 1.8436D+00, 1.8577D+00, 1.8717D+00, 

1.885 7D+ 0 0 , 1 . 8998D+00 , 1.9138D+00, 1.9279D+00, 1.9419D+00, 1.9559D+00, 

1.970 0D+ 0 0 , 1.9840D+00, 1.9980D+00 

°_ DTC _ TBL6 _ 2 = 2 • 02220+00 , 2 . 0463D+00 , 2 . 07 04D+0 0 , 2.0945D+00, 2.1187D+00, 

2 . 1428D+00 , 2.166 9D+0 0 , 2.1910D+00, 2.2152D+00, 2.2393D+00, 2.2634D+00, 

2 . 2914D+00 , 2 . 3193D+00 , 2.3473D+00, 2.3753D+00, 2.4032D+00, 2.4312D+00, 

2 . 4592D+00 , 2.4871D+00, 2.5151D+00 

°_ DTC _ TBL7 _ 2 = 2 • 54300+00 , 2 . 5710D+00 , 2 . 6038D+00 , 2.6367D+00, 2.6695D+00, 

2 . 7024D+00 , 2 . 7352D+00 , 2.7681D+00, 2.8009D+00, 2.8338D+00, 2.8666D+00, 
2.8994D+00, 2.9323D+00, 2.9651D+00, 3.0322D+00, 3.0993D+00, 3.1663D+00, 

3 . 2334D+00 , 3.3005D+00, 3.3675D+00 

°_ OTC _ TBL8 _ 2 = 3 • 43460+00 < 3 . 5017D+00 , 3 . 5744D+00 , 3.6471D+00, 3.7198D+00, 

3 . 7926D+00 , 3.8653D+00, 3.9380D+00, 4.0107D+00, 4.0834D+00, 4.1562D+00, 
4.300 1D+ 0 0 , 4 . 4441D+00 , 4.5880D+00, 4.7320D+00, 4.8760D+00, 5.0199D+00, 
5.2408D+00, 5 . 4616D+00 , 5.6825D+00 

°_ OTC _ TBL9 _ 2 = 5 • 90330+00 - 6 . 1242D+00 , 6 . 1242D+00 , 6.1242D+00, 6.1242D+00, 

6 . 1242D+00 , 6 . 1242D+00 , 6.1242D+00, 6.1242D+00, 6.1242D+00, 6.1242D+00, 

6 . 1242D+00 , 6 . 1242D+00 , 6.1242D+00, 6.1242D+00, 6.1242D+00, 6.1242D+00, 

6 . 1242D+00 , 6 . 1242D+00 , 6.1242D+00 

°_ DTC _ TBL10 _ 2 = 6 - 12420+00 , 6 . 1242D+00 , 6 . 1242D+00 , 6.1242D+00, 6.1242D+00, 
6 . 1242D+00 , 6 . 1242D+00 , 6.1242D+00, 6.1242D+00, 6.1242D+00, 6.1242D+00, 

6 . 1242D+00 , 6 . 1242D+00 , 6.1242D+00, 6.1242D+00, 6.1242D+00, 6.1242D+00, 

6 . 1242D+00 , 6 . 1242D+00 , 6.1242D+00 

# 

# DTC for SPCM 5 

# 

°_ DTC _ TBL1 _ 5=1 • 01490+00 , 1 . 0558D+00 , 1 . 0292D+00 , 1.0458D+00, 1.0491D+00, 

1 . 0524D+00 , 1 . 0573D+00 , 1.0623D+00, 1.0673D+00, 1.0735D+00, 1.0798D+00, 

1 . 0861D+00 , 1 . 0924D+00 , 1.0976D+00, 1.1029D+00, 1.1081D+00, 1.1134D+00, 

1 . 1186D+00 , 1.1238D+00, 1.1306D+00 

D _ DTC _ TBL2 _ 5=1 • 13740+00 , 1.1442D+00, 1 . 1509D+00 , 1.1577D+00, 1.1645D+00, 
1.1713D+00, 1 . 1780D+00 , 1.1848D+00, 1.1919D+00, 1.1989D+00, 1.2060D+00, 
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1.2130D+00, 

1 . 2553D+00 , 

D_DTC_TBL3_5 

1.3175D+00, 

1 . 3667D+00 , 
1.4159D+00, 
D _ DTC _ TBL 4_5 
1 . 5089D+00 , 

1 . 5673D+00 , 

1 . 6233D+00 , 
D_DTC_TBL5_5 
1 . 7220D+00 , 

1 . 8042D+00 , 

1 . 9141D+00, 

D _ DTC _ TBL6 _ 5 
2 . 0521D+00, 

2 . 1492D+00, 

2 . 2741D+00 , 

D _ DTC _ TBL7 _ 5 
2 . 5147D+00 , 

2 . 7248D+00 , 

2 . 9408D+00, 

D _ DTC _ TBL8 _ 5 
3 . 3412D+00 , 

3 . 7780D+00 , 

4 . 3545D+00 , 

D _ DTC _ TBL9 _ 5 
5 . 6109D+00 , 
7.4454D+00, 
7.4454D+00, 

D _ DTC _ TBL10 _ 

7.4454D+00, 

7.4454D+00, 

7.4454D+00, 


1.2201D+00, 

1.2624D+00, 

= 1.2 76 5D+ 0 0 , 
1 .3257D+00, 

1 .3749D+00, 

1 .4275D+00, 

= 1.450 8D+ 0 0 , 
1.5206D+00, 

1 . 5766D+00 , 

1 . 6326D+00 , 

= 1 . 6582D+00, 
1.7348D+00, 
1.8225D+00, 
1.9324D+00, 
=1 . 9690D+00 , 
2 . 0683D+00 , 

2 . 1654D+00 , 

2 . 3 042D+0 0 , 
=2 . 3643D+00, 
2 . 5447D+00 , 

2 . 7608D+00 , 

2 . 9908D+00 , 
=3 . 0909D+00 , 

3 . 3 912D+0 0 , 

3 . 8622D+00 , 

4 . 4744D+00 , 
=4 . 7142D+00 , 
5 . 8299D+00 , 

7 .4454D+00, 

7 . 4454D+00 , 
5=7 .4454D+00 
7 .4454D+00, 

7 .4454D+00, 

7 .4454D+00, 


1 . 2271D+00 , 
1 . 2695D+00 
1 . 2847D+00 
1 . 3339D+00 , 
1 . 3831D+00 , 
1 . 4 3 91D+0 0 
1 . 4624D+00 
1 . 5299D+00 , 
1 . 5859D+00 , 
1 . 6454D+00 
1 . 6709D+00 
1 . 7476D+00 , 
1 . 8408D+00 , 
1 . 9507D+00 
1 . 9873D+00 
2 . 0845D+00 , 
2 . 1816D+00 , 
2 . 3343D+00 
2 . 3944D+00 
2 . 5807D+00 , 
2 . 7968D+00, 
3 . 0409D+00 
3 . 1410D+00 
3 . 4413D+00 , 
3 . 9464D+00 , 
4 . 5943D+00 
4 . 8341D+00 
6 . 0488D+00 , 
7 . 4454D+00 , 
7 . 4454D+00 
, 7 . 4454D+0 
7 . 4454D+00 , 
7 . 4454D+00 , 
7 . 4454D+00 


1 .2342D+00, 

, 1.2929D+00 
1.3421D+00, 
1.3913D+00, 

, 1.4740D+00 
1 . 5392D+00 , 
1.5953D+00, 

, 1 . 6837D+00 
1 . 7603D+00 , 
1 . 8591D+00 , 

, 2 . 0035D+00 
2 . 1007D+00 , 
2 . 1978D+00 , 

, 2 . 4245D+00 
2 . 6167D+00 , 
2 . 8328D+00 , 

, 3 . 1910D+00 
3 . 5254D+00 , 
4 . 0305D+00, 

, 4 . 954 0D+0 0 
6 . 3980D+00 , 
7 . 4454D+00 , 

0, 7 . 4454D+0 

7 . 4454D+00 , 
7 . 4454D+00 , 


1.2412D+00, 

, 1 . 3011D+00 
1 . 3503D+00 , 

1 . 3 995D+0 0 , 

, 1.485 7D+ 0 0 
1 . 5486D+00 , 
1 . 6046D+00 , 

, 1 . 6965D+00 
1 . 7731D+00 , 
1 . 8775D+00 , 

, 2 . 0197D+00 
2.1169D+00, 
2.214 0D+0 0 , 

, 2 . 4545D+00 
2 . 6528D+00 , 
2 . 8688D+00 , 

, 3 . 2411D+00 
3 . 6096D+00 , 
4 . 1147D+00 , 

, 5.1730D+00 
6 . 7471D+00 , 
7 . 4454D+00 , 

0, 7 . 4454D+0 
7 . 4454D+00 , 
7 . 4454D+00 , 


1 . 24 83D+0 0 

, 1.3093D+0 
1 . 3585D+00 
1 . 4077D+00 

, 1 . 4 973D+0 
1 . 5579D+0 0 
1 . 6139D+00 

, 1.7093D+0 
1 . 7859D+00 
1 . 8978D+00 

, 2 . 0359D+0 
2 . 1331D+00 
2 . 2441D+00 

, 2 . 4846D+0 
2 . 6888D+00 
2 . 9048D+00 

, 3.2911D+0 
3 . 6938D+00 
4 . 2346D+00 

, 5.3919D+0 
7 . 0962D+00 
7 . 4454D+00 

0, 7.4454D+ 
7 . 4454D+00 
7 . 4454D+00 


# 

# DTC for SPCM 6 

# 


D _DT C _ TBL1 _6 
1 . 0374D+00 , 

1 . 0681D+00, 

1 . 0904D+00 , 

D _ DTC _ TBL2 _ 6 
1 . 1288D+00, 

1 . 1636D+00 , 
1.2029D+00, 
D _E)TC_T BL 3_6 
1 . 2557D+00 , 

1 . 2957D+00 , 

1 . 3356D+00 , 
D _DTC_ TBL 4_6 
1 . 4098D+00 , 
1.4717D+00, 

1 . 5357D+00, 

D _ DTC _ TBL5 _ 6 
1 . 6226D+00, 

1 . 6884D+00, 

1 . 7835D+00, 

D _ DTC _ TBL6 _ 6 
1 . 9324D+00 , 


=1 . 0085D+00 
1 . 0402D+00 , 
1 . 0755D+00 , 
1 . 0934D+00 , 
=1 . 1035D+00 
1.1338D+00, 
1 . 1701D+00 , 
1 . 2 0 95D+0 0 , 
=1 . 2226D+00 
1.2624D+00, 
1.3023D+00, 
1 . 3422D+00 , 
=1 . 3591D+00 
1.4199D+00, 
1 . 4824D+00 , 
1 . 5464D+00 , 
=1 . 5677D+00 
1 . 6335D+00 , 
1 . 6 994D+0 0 , 
1 . 8017D+00 , 
=1 . 8383D+00 
1 . 9533D+00 , 


, 1 . 0468D+00 
1 . 0431D+00 , 
1 . 0785D+00 , 
1 . 0985D+00 
, 1 . 1086D+00 
1.13 8 9D+0 0 , 
1 . 1767D+00 , 
1 . 2160D+00 
, 1 . 2291D+00 
1 . 2690D+00 , 
1 . 3 0 90D+0 0 , 
1 . 3489D+00 
, 1 . 3692D+00 
1.430 1D+0 0 , 
1.4930D+00, 
1 . 5571D+00 
, 1 . 5787D+00 
1 . 6445D+00 , 
1 . 7103D+00 , 
1 . 8200D+00 
, 1 . 8566D+00 
1 . 9742D+00 , 


, 1 . 0075D+00 
1 . 0459D+00, 
1 . 0815D+00, 

, 1 . 1136D+00 
1.1439D+00, 
1.1832D+00, 

, 1 . 2358D+00 
1 .2757D+00, 
1.3156D+00, 

, 1 . 3793D+00 
1 .4402D+00, 
1.5037D+00, 

, 1 . 5897D+00 
1.6555D+00, 
1 . 7286D+00 , 

, 1.8749D+00 
1 . 9952D+00 , 


, 1 . 0343D+00 
1 . 0533D+00 , 
1 . 0845D+00 , 

, 1 . 1187D+00 
1.1505D+00, 
1.1898D+00, 

, 1 . 2424D+00 
1 .2824D+00, 
1 . 3223D+00 , 

, 1.3895D+00 
1 . 4504D+00 , 
1.5144D+00, 

, 1.600 6D+ 0 0 
1 . 6665D+00 , 
1.746 9D+0 0 , 

, 1.8931D+00 
2 . 0161D+00 , 


, 1 . 0358D+0 
1 . 0607D+00 
1 . 0874D+00 

, 1 . 1237D+0 
1 . 1570D+00 
1 . 1963D+00 

, 1 . 2491D+0 
1 . 2890D+00 
1 . 3289D+00 

, 1 . 3 996D+0 
1 . 4610D+00 
1 . 5251D+00 

, 1 . 6116D+0 
1 . 6774D+00 
1 . 7652D+00 

, 1 . 9114D+0 
2 . 0370D+00 
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2 . 0579D+00 , 2 . 0789D+00 , 2.0998D+00, 

2 . 1886D+00 , 2 . 2147D+00 , 2.2407D+00 
D_E)TC_TBL7_6= 2 . 2668D+0° , 2 .2928D+00, 
2.3970D+00, 2.4230D+00, 2.4491D+00, 

2 . 5816D+00 , 2 . 6172D+00 , 2.6527D+00, 
2.7947D+00, 2.8302D+00, 2.8657D+00 
D_DTC_TBL8_6=2 . 9087D+00, 2 . 9516D+00, 
3 . 1234D+00 , 3 . 1663D+00 , 3.2093D+00, 

3 . 4075D+00 , 3.476 9D+0 0 , 3.5462D+00, 
3.8238D+00, 3.8932D+00, 3.9626D+00 
D_DTC_TBL9_6=4 . 0605D+00 , 4 .1583D+00, 
4.5498D+00, 4.6477D+00, 4.7456D+00, 

5 . 4244D+00 , 5.5941D+00, 5.7638D+00, 

6 . 8142D+00 , 7 . 0768D+00 , 7.0768D+00 
D_ D TC_ TBL10 _6=7 . 0768D+00 , 7 . 0768D+00 
7 . 0768D+00 , 7.076 8D+0 0 , 7.0768D+00, 

7 . 0768D+00 , 7 . 0768D+00 , 7.0768D+00, 

7 . 0768D+00 , 7 . 0768D+00 , 7.0768D+00 

DTC for SPCM 8 

# 

D_DTCJTBL1_8=9 . 6968D-01, 9 . 9754D-01, 
1.0217D+00, 1 . 0257D+00 , 1.0297D+00, 

1 . 0591D+00 , 1.0630D+00, 1.0669D+00, 

1 . 0849D+00 , 1 . 0910D+00 , 1.0972D+00 
D_ D TC_TB L2 _8= 1 . 1034D+00 , 1 . 1096D+00 , 
1 . 1341D+00 , 1 . 1402D+00 , 1.1462D+00, 
1.1704D+00, 1 . 1764D+00 , 1.1825D+00, 

1 . 2085D+00 , 1 . 2164D+00 , 1.2242D+00 
°_ DTC _ TBL3 _ 8 = 1 - 23210+00 - 1 . 2400D+00 , 
1 . 2715D+00 , 1 . 2794D+00 , 1.2873D+00, 

1 . 3188D+00 , 1 . 3285D+00 , 1.3383D+00, 

1 . 3772D+00 , 1.387 0D+0 0 , 1.3967D+00 
D_DTC_TBL4__8 = 1 . 4065D+00 , 1.4150D+00, 
1.4492D+00, 1 . 4577D+00 , 1.4663D+00, 

1 . 5005D+00 , 1 . 5045D+00 , 1.5085D+00, 

1 . 5245D+00 , 1 . 5285D+00 , 1.5325D+00 
D_E)TC_TBL5_8 = 1 . 5365D+00, 1 . 5405D+00 , 
1 . 5565D+00 , 1 . 5605D+00 , 1.5657D+00, 

1 . 5862D+00 , 1.5914D+00, 1.5965D+00, 

1 . 6171D+00 , 1 . 6222D+00 , 1.6274D+00 
D_E)TC_TBL6_8 = 1 . 6325D+00, 1 . 63 77D+0 0 , 
1 . 6886D+00 , 1.708 9D+0 0 , 1.7293D+00, 
1.81 0 6D+ 0 0 , 1 . 8309D+00 , 1.8512D+00, 
1.9302D+00, 1 . 9497D+00 , 1.9693D+00 
D_ D TC_TBL7_8= 1 . 9888D+00 , 2 . 0083D+00, 
2 . 0865D+00 , 2 . 1060D+00 , 2.1256D+00, 
2.3140D+00, 2 . 3611D+00 , 2.4082D+00, 

2 . 6198D+00 , 2 . 6785D+00 , 2.7372D+00 
D_ d TC_TBIj8_8= 2 . 7959D+00 , 2 . 8546D+00 , 
3.145 0D+ 0 0 , 3 . 2315D+00 , 3.3179D+00, 

3 . 7318D+00 , 3 . 8862D+00 , 4.0406D+00, 

4 . 7427D+00 , 4.9394D+00, 5.1360D+00 
D_ d TC_TBIj9_8 = 5 . 3326D+00 , 5 . 96 54D+0 0 , 
6 . 5982D+00 , 6.5982D+00, 6.5982D+00, 

6 . 5982D+00 , 6.5982D+00, 6.5982D+00, 

6 . 5982D+00 , 6.5982D+00, 6.5982D+00 
D_ DT C__TB L1 °_8=6 . 5982D+00 , 6 . 5982D+00 
6 . 5982D+00 , 6.5982D+00, 6.5982D+00, 


2.120 7D+0 0 , 2 . 1417D+00 , 2.1626D+00, 

2.3189D+00, 2 . 3449D+00 , 2.3709D+00, 

2 . 4751D+00 , 2 . 5106D+00 , 2.5461D+00, 

2 . 6882D+00 , 2.7237D+00, 2.7592D+00, 

2 . 9946D+00 , 3.0375D+00, 3.0804D+00, 

3 . 2522D+00 , 3.2951D+00, 3.3381D+00, 

3 . 6156D+00 , 3.6850D+00, 3.7544D+00, 

4 . 2562D+00 , 4.3541D+00, 4.4520D+00, 

4 . 9153D+00 , 5 . 0850D+00 , 5.2547D+00, 

6 . 0264D+00 , 6 . 2890D+00 , 6.5516D+00, 

, 7 . 0768D+00 , 7.076 8D+0 0 , 7.0768D+00, 
7 . 0768D+00 , 7 . 0768D+00 , 7.0768D+00, 

7 . 0768D+00 , 7 . 0768D+00 , 7.0768D+00, 


1 . 0047D+00 , 1 . 0102D+00 , 1.0177D+00, 
1.0382D+00, 1 . 0467D+00 , 1.0551D+00, 
1.0708D+00, 1 . 0748D+00 , 1.0787D+00, 

1 . 1157D+00 , 1.1219D+00, 1.1281D+00, 
1.1523D+00, 1 . 1583D+00 , 1.1643D+00, 
1.1885D+00, 1 . 1946D+00 , 1.2006D+00, 

1 . 2479D+00 , 1 . 2557D+00 , 1.2636D+00, 

1 . 2951D+00 , 1.3030D+00, 1.3109D+00, 
1.3480D+00, 1 . 3578D+00 , 1.3675D+00, 

1 . 4236D+00 , 1.4321D+00, 1.4407D+00, 
1.4748D+00, 1 . 4834D+00 , 1.4919D+00, 
1.5125D+00, 1 . 5165D+00 , 1.5205D+00, 

1 . 5445D+00 , 1 . 5485D+00 , 1.5525D+00, 
1.5708D+00, 1.576 0D+0 0 , 1.5811D+00, 
1.6017D+00, 1 . 6068D+00 , 1.6120D+00, 

1 . 6428D+00 , 1.647 9D+ 0 0 , 1.6683D+00, 
1.7496D+00, 1 . 7699D+00 , 1.7902D+00, 
1.8716D+00, 1.8911D+00, 1.9106D+00, 

2 . 0279D+00 , 2 . 0474D+00 , 2.0669D+00, 

2 . 1727D+00 , 2 . 2198D+00 , 2.2669D+00, 

2 . 4553D+00 , 2.5024D+00, 2.5611D+00, 

2 . 9133D+00 , 2 . 9720D+00 , 3.0585D+00, 

3 . 4044D+00 , 3 . 4909D+00 , 3.5774D+00, 

4 . 1950D+00 , 4 . 3494D+00 , 4.5461D+00, 

6 . 5982D+00 , 6.5982D+00, 6.5982D+00, 

6 . 5982D+00 , 6.5982D+00, 6.5982D+00, 

6 . 5982D+00 , 6.5982D+00, 6.5982D+00, 

, 6 . 5982D+00 , 6.5982D+00, 6.5982D+00, 
6 . 5982D+00 , 6.5982D+00, 6.5982D+00, 
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6 . 5982D+00 , 6.5982D+00, 6.5982D+00, 6.5982D+00, 6.5982D+00, 6.5982D+00, 
6 . 5982D+00 , 6.5982D+00, 6.5982D+00 
# 

# Maximum LIDAR value for 532 nm 

# 

gD_G_MAXL I D = 200. OdO 

# 

# digital to analog convrsn lookup table 

# 


D_D2A_TBL1=0, 1 

, 2, 

, 3 

, 4, 

5, 6, 

7, 8, 9, 10, 11 

, 12, 13, 

14, 

15, 16 

, 17 

, 18, 19, 20 

D_D2A_TBL2=21, 
39, 40, 41 

22, 

23 

, 24, 

25, 

26, 27, 28 

, 29, 

30, 31, 32 

, 33 

, 34, 

35, 

36, 37 

, 38, 

D_D2A_TBL3=42 , 
60, 61, 62 

43 , 

44 

, 45, 

46, 

47, 48, 49 

, 50, 

51, 52, 53 

, 54 

, 55, 

56, 

57, 58 

, 59, 

D_D2A_TBL4=63 , 
81, 82, 83 

64, 

65 

, 66, 

67, 

68, 69, 70 

, vi, 

72, 73, 74 

, 75 

, 76, 

77, 

78, 79 

, 80, 

D_D2A_TBL5=84 , 
101, 102, 103 

85, 

86 

, 87 

, 88, 

89, 90, 91, 92 

, 93, 94, 

95, 

96, 97, 98, 99, 

100, 

D_D2A_TBL6=104 , 
118, 119, 120 

105, 

106, 

107, 

108, 109, 

110, 

111, 112, 

113, 

114, 

115 

, H6, 

117, 

D_D2A_TBL7=12 1 , 
135, 136, 137 

122, 

123, 

124, 

125, 126, 

127, 

128, 129, 

130 

, 131, 

132 

, 133, 

134, 

D_D2A_TBL8 = 13 8 , 
152, 153, 154 

139, 

140, 

141, 

142, 143, 

144, 

145, 146, 

147, 

148, 

149 

, 150, 

151, 

D_D2A_TBL9=155 , 
169, 170, 171 

156, 

157, 

158, 

159, 160, 

161, 

162, 163, 

164, 

165, 

166 

, 167, 

168, 

D_D2A_TBL1 0=172 
186, 187, 188 

, 173 , 

174, 

, 175 

, 176, 177, 

178, 

179, 180, 

181 

, 182, 

183 

, 184, 

185, 

D_D2A_TBL11=189 
203, 204, 205 

, 190, 

191, 

, 192 

, 193, 194, 

195, 

196, 197, 

198 

, 199, 

200 

, 201, 

202, 

D_D2A_TBL12 = 2 0 6 
219, 220, 221 

, 206, 

207, 

, 208 

, 209, 210, 

211, 

212, 213, 

214 

, 215, 

216 

, 217, 

218, 

D_D2A_TBL13=222 
236, 237, 238 

, 223, 

224, 

, 225 

, 226, 227, 

228, 

229, 230, 

231 

, 232, 

233 

, 234, 

235, 

D_D2A_TBL14=239 
253, 254,255 

, 240, 

241, 

, 242 

, 243, 244, 

245, 

246, 247, 

248 

, 249, 

250 

, 251, 

252, 


# 

# L_Alt TX Flag upper Limit and Lower Limit 

# 


GI_TXLWLIM_FLG = 195 
GI_TXUPLIM_FLG = 205 
# 

# Maximum LIDAR value for 1064 nm 

# 


GD_IR_MAXLID = 500. OdO 

# 

# L_Eng constants 

# 


GD_AP21_C0NST1 
GD_AP2 1_C0NST2 
GD_AP21_C0NST3 
GD_AP21_C0NST4 
GD_AP2 1_C0NST5 
GD_AP21_C0NST6 
GD_AP2 1_C0NST7 
GD_AP21_C0NST8 
GD_AP2 1_C0NST9 
GD_AP21_CONST10 
GD AP2 1 C0NST11 


9.22D0 
10 . ODO 
1 . 52D0 
4 . ODO 
0 .408D0 

2 . ODO 

0 .41D0 

3 . ODO 

0 .407D0 
= 9.2D0 
= 8. ODO 


Version 7.0 


Page B-14 


March 2013 



ANC07 Format, Files and Contents 


The GLAS Science Algorithm Software (GSAS) Us- 


GD_AP21_CONST12 = 1.25D0 
GD_AP21_C0NST13 = 9.25D0 
GD_AP21_C0NST14 = 13 . 0D0 
GD_AP21_C0NST15 = 1.514D0 
GD_AP21_C0NST16 = 1.91D0 
GD_AP21_C0NST17 = 3.52D0 
GD_AP21_C0NST18 = 0.66D0 
GD_AP21_CONST19 = -3.515D0 
GD_AP2 1_C0NST2 0 = 0.63D0 
GD_AP2 l_CONST2 1 = 1.515D0 
GD_AP21_C0NST22 = -1.532D0 
GD_AP21_CONST23 = 1.49D0 
GD_AP21_C0NST24 = -1.52D0 
GD_AP2 1_C0NST2 5 = 2.05D0 
GD_AP2 1_C0NST2 6 = 4.05D0 
GD_AP2 1_C0NST2 7 = -4.028D0 
GD_AP2 1_C0NST2 8 = 0.054D0 
GD_AP21_C0NST29 = 7 . 0D0 
GD_AP2 1_C0NST3 0 = 0.052D0 
GD_AP2 1_C0NST3 1 = 5 . 0D0 
GD_AP21_CONST32 = 30.0D0 
GD_AP2 l_CONST3 3 = 3 0.2D0 
# 

# L_ENG COEF ARRAYS 

# 

GD_LSROSCA_COEF = 1.898D0 
GD_LSROSCB_COEF = 0.4878D0 
GD_LSROSCC_COEF = -1.406D-2 
GD_LSRAMPA_COEF = 2.062D0 
GD_LSRAMPB_COEF = 0.4865D0 
GD_LSRAMPC_COEF = -1.406D-2 
GD_LSRDR_COEF = 131 . 08D0 , 0 . 512D0 
GD_ADDETGN_COEF = -IDO , 0 . 0078125D0 
GD_DPINA1_C0EF = 0.5609DO 
GD_DPINA2_COEF = 0.3823DO 
GD_D P I NA3 _COE F = 3.848D-5 
GD_DPINA4_COEF = -5.737D-3 
GD_DPINB1_C0EF = 1.108D0 
GD_DPINB2_COEF = 0.4143DO 
GD_DPINB3_COEF = 8.671D-5 
GD_DPINB4_COEF = -1.159D-3 
GD_53 2NRG1_C0EF = -0.969D0 
GD_53 2NRG2_C0EF = 0.4095D0 
GD_532NRG3_C0EF = -6.601D-5 
GD_53 2NRG4_C0EF = 8.765D-3 
GD_SPCM_COEF = 0 . 0D0 , 3 . 5 8 IDO 
GD_INTTMP1_C0EF = -50 . 0D0 , 0 . 781D0 
GD_INTTMP2_C0EF = 9 . 0D0 , 0 . 03 IDO 
GD_V C_C°E F = -100 . 0D0, 0 . 048828125D0 
GD_XY_C°EF = -10 . 0D0, 0 . 0048828125D0 

GD_AP20_1_COEF = - 3 3 . 84D0 , 5 . 3 6 8D- 1 , - 1 . 622D- 3 , 3 . 155D- 6 

GD_AP2 0_2_COEF = 2 0 . 84D0 , 1 . 032D- 1 , - 2 . 8 7 9D- 5 , 1 . 44 6D- 7 

GD_AP21_l_COEF = 0 . 0D0 , 0 . 026DO 

GD_AP2 l_2_COEF = 0 . 0D0 , 0 . 052D0 

GD_AP22_l_COEF = - 2 0 . 4D0 , 0 . 3 984D0 

GD_AP22_2_COEF = - 2 3 . 5D0 , 0 . 3 984D0 

GD_AP22_3_COEF = - 2 1 . 6D0 , 0 . 3 984D0 

GD_AP22_4_COEF = - 2 1 . 0D0 , 0 . 3 984D0 

GD_AP22_5_COEF = - 2 0 . 7D0 , 0 . 3 984D0 
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GD_AP22_6_COEF = 
GD_AP22_7_COEF = 
GD_AP23_l_COEF = 
GD_AP 2 3 _2 _COE F = 
GD_AP 2 3 _3 _COE F = 
GD_AP23_4_COEF = 
GD_AP23_5_COEF = 
GD_AP23_6_COEF = 
GD_AP23_7_C0EF = 
GD_AP23_8_COEF = 
GD_AP5 0_OTS_COEF 
GD_AP50_1_COEF = 
GD_AP5 0_2_COEF = 
GD_AP5 0_3_COEF = 
GD_AP5 0_4_COEF = 
GD_AP5 0_5_COEF = 
GD_AP5 0_6_COEF = 
GD_AP5 0_7_COEF = 
GD_AP5 0_8_COEF = 
GD_AP5 0_9_COEF = 
GD_AP50_10_COEF : 
GD_AP50_11_COEF : 
GD_AP5 0_12_COEF : 
GD_AP5 0_13_COEF : 
GD_AP5 0_14_COEF : 
GD_AP25_l_COEF = 
GD_AP55_l_COEF = 
# 


-18 . 113D0, 0 .3083D0 
0D0, 0 .2949D0 

-1456 . 13D0, 0 . 5664 0 55 7 03DO 
-2 . 0D0, 976 . 5625D-6 

0 . 1586D0 , 0 .1027D0, -4 . 23 53D- 05 , 3 . 83 3D- 07 
0 . 14D0 , 0 . 104D0, -5 . 962D-05, 4 . 304D-07 
0 . 1392D0, 0 .104D0, -5.962D-05,4 . 304D-07 
29 .27D0, 0 . 09251D0 , 9 .919D-06,1.022D-07 
0 . 02609D0 , 0 . 1173D0, -6 . 8 7 ID- 05, 2 . 629D-07 
-7 . 696D0, 0 .11D0, -5 . ID- 05, 2 . 007D-07 
= 0 . 0D0, 0 .256D0 
4 0D0 , -0 . 15625D0 

0 . 1586D0 , 0 .1027D0, -4.253D-05,3. 833D-07 
0 . 025O6D0 , 0 . 1051D0, -6 .469D-05, 4 . 376D-07 
0 . 1392D0, 0 .104D0, -5.962D-05,4 . 304D-07 
29 . 27D0, 0 . 09251D0 , 9 .919D-06,1.022D-07 
0 . 02609D0 , 0 . 1173D0 , -6 . 8 7 ID- 05, 2 . 629D-07 
-7 . 696D0 , 0 .11D0, -5 . ID- 05, 2 . 007D-07 
0 . 0008D0, 0 . 003678D0 
-0 . 0008D0 , 0 . O03113D0 
0 . 0008D0, 0 . 00311DO 
1.35D-3, 0.003468DO 

-33 . 84D0 , 0 . 5368D0, -1 .622D-3 , 3 . 155D-6 
-2 . 406D0 , 0 . 06459D0 , -7 . 58D-6, 5 . 591D-8 
13 . 33D0 , 0 . 06518D0 , -5 . 2 6 ID- 6 , 4 . 076D-8 
0 . 0D0, 0 . 125D0 
0 . ODO, 0 . 128D0 


# Psuedo Telemetry eq. constants 

# 


PSETLM_F0_N 
PSETLM_F1_N 
PSETLM_F2_N 
PSETLM_F3_N 
PSETTEMP1_N 
PSETTEMP2JST 
PSETTEMP1_D 
PSETTEMP2_D 
PSETTEMP1 = 
PSETTEMP2 = 


= -273.15D0 
= 1 . 0185D-3 
= 2 . 4090D-4 
= 1.4990D-7 
= 5. ODO 
= 7.5D0 
= 255. ODO 
= 7680. ODO 
0 . ODO 
0 . ODO 


################################################### 

# L_Eng Nominal On-Orbit Operations Limits 

# Due to volume of limits they are formatted as 

# do rather than . OdO 

################################################### 

# AP20 Red Low, Yellow Low, Yellow High, Red High 

################################################### 


GD_LMB IRE F_T_L I M = 9d0 , lOdO , 30d0 , 35d0 
GD_LSR1DBLR_T_LIM = lOdO , 35d0 , 45d0 , 55d0 
GD_LSR10SC_T_LIM = lOdO , 15d0 , 34 . 5d0 , 35d0 
GD_L1ELEC_T_LIM = OdO , 4d0 , 34d0 , 40d0 
GD_L S RO S C_C_L I M = OdO, 82d0, 95d0, 96 dO 
GD_L S RAM P_C_L I M = OdO , 96d0 , 102d0 , 102 . 5d0 
GD_LSRDR_PW_LIM = OdO , 185d0 , 2 15d0 , 22 OdO 
GD_LMB 2 RE F_T_L I M = 9d0 , lOdO , 30d0 , 35d0 
GD_LSR2DBLR_T_LIM = lOdO , 35d0 , 45d0 , 55d0 
GD_L S R2 0 S C_T_L I M = lOdO , 15d0 , 34 . 5d0 , 35d0 
GD_L 2 E L E C_T_L I M = OdO , 4d0 , 34d0 , 40d0 
GD_LMB 3 RE F_T_L I M = 9d0 , lOdO , 30d0 , 35d0 
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GD_LSR3DBLR_T_LIM = lOdO , 35d0 , 45d0 , 55d0 
GD_LSR30SC_T_LIM = lOdO , 15d0 , 34 . 5d0 , 35d0 
GD_L 3 E L E C_T_L I M = OdO , 4d0 , 34d0 , 40d0 
GD_D P I NA_L I M = - ldO , OdO , 1 0 OdO , 2 5 OdO 
GD_DPINB_LIM = - ldO , OdO , 1 0 OdO , 2 5 OdO 
GD_G_NRG_ L 1 M = - 2d0 , - ldO , 7 OdO , 72d0 
GD_PR I MAD 5 5 0 V_L I M = -20d0 , 422d0 , 578d0 , 607d0 
GD_S E CAD 55 0 V_L I M = - 3 OdO , - 2 OdO , 2 OdO , 422d0 
GD_SPCM1_550V_LIM = -20d0 , 510d0 , 578d0 , 607d0 
GD_SPCM2_550 V_L I M = -20d0 , 510d0 , 578d0 , 607d0 
GD_SPCM3_550V_LIM = - 3 OdO 2 OdO , 2 OdO , 3 OdO 
GD_S PCM4_5 5 0 V_L IM = - 3 OdO 2 OdO , 2 OdO , 3 OdO 
GD_SPCM5_550V_LIM = -20d0 , 525dO , 578d0 , 607d0 
GD_SPCM6_550V_LIM = -20d0 , 505d0 , 578d0 , 607d0 
GD_SPCM7_550V_LIM = - 3 OdO 2 OdO , 2 OdO , 3 OdO 
GD_SPCM8_550V_LIM = -20d0 , 505d0 , 578d0 , 607d0 
GD_I NT 1_T_L I M = -18 dO, -lOdO, 70 dO, 80d0 
GD _CT_PRAI L _V_L];M = lOdO, lido, 13d0, 14d0 
GD_I NT 3 _T_L I M = - 18d0 , - lOdO , 70d0 , 8 OdO 
GD_V CXMTR__C_L I M = -4 OdO 3 OdO , 3 OdO , 4 OdO 
GD_V C YMTR__C__L I M = -4 OdO 3 OdO , 3 OdO , 4 OdO 
GD_XP0S_LIM = -4 . Ido, -3 . 5d0, 3 . 5dO , 4 . ldO 
GD_YP0S_LIM = -4 . ldO , -3 . 5d0, 3 . 5dO , 4 . ldO 
################################################## 

# AP21 Red Low, Yellow Low, Yellow High, Red High 
################################################# 
GD_BUSAINST_2 8V_JLIM = 24d0 , 25d0 , 35 . ldO , 35 . 5d0 
GD_HBSUPP_C_LIM = -2d0 , - ldO , 4dO , 4 . 5d0 
GD_HVPSDETSUP_C_LIM = -2dO , -ldO , 1 . 4dO , 1 . 6d0 
GD_0PHTR_C_LIM = - 2d0 , - ldO , 3 . ldO , 3 . 3d0 
GD_MECHSYS_C_LIM = - 2d0 , - ldO , 1 . ldO , 1 . 5d0 
GD_BUSBL1_V_LIM = - ldO , 24 . 3d0 , 34 . 7d0 , 3 5d0 
GD_BUSBL1_C_LIM = -3 . 5d0 , 3 . 3d0 , 5d0 , 5 . 5d0 
GD_BUSCL2_V_LIM = - ldO , 24 . 3d0 , 34 . 7d0 , 3 5d0 
GD_BUSCL2_C_LIM = -3 . 5d0 , 3 . 3d0 , 5d0 , 5 . 5dO 
GD_BUSDL3_V_LIM = - ldO , 24 . 3d0 , 34 . 7d0 , 3 5d0 
GD_BUSDL3_C_LIM = -3 . 5d0 , 3 . 3d0 , 5d0 , 5 . 5d0 
GD_5VHB1_V_LIM = 4 . 8d0 , 4 . 9d0 , 5 . 3d0 , 5 . 4dO 
GD_5VHB1_C_LIM = - 2d0 , - ldO , 3 . 5d0 , 4dO 
GD_ 1 2 VHB 2 _V_L I M = 11 . 7d0 , 11 . 8d0 , 12 . 4dO , 12 . 5d0 
GD_ 1 2 VHB 2 _C_L I M = -2d0 , - ldO , 1 . 5dO , 2d0 
GD_N 1 2 VHB 3 _V_L I M = - 12 . 5d0 , -12 . 4dO , - 11 . 8dO , - 11 . 7dO 
GD_N 1 2 VHB 3 _C_L I M = - 2d0 , - ldO , 1 . 5d0 , 2d0 
GD_5VHB4_V_LIM = 4 . 8d0 , 4 . 9d0 , 5 . 3d0 , 5 . 4dO 
GD_5VHB4_C_LIM = - 2d0 , - ldO , 6 . 5d0 , 7d0 
GD_N 5 VHB 5 _V__L I M = -5 . 3d0 , -5 . 2dO , -4 . 9d0 , -4 . 8d0 
GD_N 5 VHB 5 _C_L I M = -2d0 , - ldO , 2 . 2dO , 3d0 
GD_N 5 VHB 6 _V_L I M = - 5 . 6d0 , - 5 . 5dO , - 5 . ldO , - 5d0 
GD_N 5 VHB 6 _C_L I M = -2dO , - ldO , 5dO , 6d0 
GD_15VBPR_V_LIM = 14 . 6d0 , 14 . 7dO , 15 . 3d0 , 15 . 4dO 
GD_N 1 5 VB P R_V_L I M = - 15 . 4dO , -15 . 3d0 , - 14 . 6d0 , - 14 . 5dO 
GD_12VP0SCTC_C_LIM = - 0 . 2 5d0 , - 0 . 24d0 , 0 . 24dO , 0 . 2 5dO 
GD_12VS0SCTC_C_LIM = - 0 . 2 5d0 , - 0 . 24d0 , 0 . 24dO , 0 . 2 5dO 
GD_N 2 VD V_V_L I M = -2 . 5d0 , -2 . 4dO , -1 . 7dO , - 1 . 6dO 
GD_HBHS_T_LIM = - 18d0 , - lOdO , 70d0 , 8 OdO 
GD_FETSBHS_T_LIM = - 18d0 , - 1 OdO , 7 OdO , 8 OdO 
GD_OVHVPSREF_V_LIM = - 0 . 5d0 , - 0 . 2 5d0 , 0 . 104d0 , 0 . 2 6d0 
GD_5VHVPSREF_V_LIM = 4 . 74d0 , 4 . 844d0 , 5 . 156d0 , 5 . 26d0 
########################################################### 
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# AP22 Red Low, Yellow Low, Yellow High, Red High 
########################################################## 
GD_HKBDCO_T_LIM = - 18d0 , - lOdO , 55d0 , 65d0 
GD_IPSBDC1_T_LIM = - 18d0 , - 1 OdO , 55d0 , 65d0 
GD_PCBDC2_T_LIM = - 18d0 , - lOdO , 55d0 , 65d0 
GD_CDFTBDC3_T_LIM = - 18d0 , - lOdO , 55d0 , 6 5d0 
GD_AD1DSPC4_T_LIM = - 18d0 , - lOdO , 6 OdO , 7 OdO 
GD_AD2DSPC5_T_LIM = - 18d0 , - 17d0 , 6 OdO , 7 OdO 
GD_DCHBDC6_T_LIM = - 18d0 , - 1 OdO , 55d0 , 65d0 
GD_LMBDC7_T_LIM = - 18d0 , - lOdO , 55d0 , 65d0 
GD_0XC01BDC9_T_LIM = - 18d0 , - lOdO , 55d0 , 65d0 
GD_OXCO2BDC10_T_LIM = - 18d0 , - 1 OdO , 55d0 , 6 5d0 
GD_0SCBDC11_T_LIM = - 18d0 , - lOdO , 55d0 , 6 5d0 
GD_0TSBDC12_T_LIM = - 18d0 , - lOdO , 55d0 , 6 5d0 

GD_L P AC 1 3 _T 1_L I M = - 18d0 , - 1 OdO , 45d0 , 4 6d0 
GD_L P AC 1 4 _T2 _L I M = - 18d0 , - 1 OdO , 45d0 , 4 6d0 
GD_AD 1ECLAC15_T_LIM = - 18d0 , - 1 OdO , 6 OdO , 78d0 
GD_AD 2ECLAC16_T_LIM = - 18dO , - 17d0 , 6 OdO , 78d0 
GD_AD 1 ECLBC 1 7_T_LIM = - 18dO , - 1 OdO , 6 OdO , 78d0 
GD_AD2ECLBC18_T_LIM = - 18d0 , - 17d0 , 6 OdO , 78d0 
GD_AD1ADCC19_T_LIM = - 18d0 , - lOdO , 6 OdO , 7 8dO 
GD_AD2ADCC20_T_LIM = - 18d0 , - 17d0 , 6 OdO , 7 8d0 
GD_L I D_BOX_T_L I M = - 2 8d0 , - 2 5d0 , 3 ldO , 4 ldO 
GD_PRTTELMTC2 2 T_L IM = - 6 8d0 , -4 OdO , 3 OdO , 4 OdO 
GD_PRTTELBFC2 3T_LIM = - 6 8d0 , -4 OdO , 3 OdO , 4 OdO 
GD_PRTAD1C24_T_LIM = - 13 . 5d0 , - 8d0 , 3 OdO , 4 OdO 
GD_PRTAD2C25_T_LIM = - 18d0 , - 13 . 5d0 , 3 OdO , 4 OdO 
GDF1LTRSRSC2 6_T_LIM = - 17d0 , - 12d0 , 2 9d0 , 3 7d0 
GDF2LTRSRSC2 7_T_LIM = - 17d0 , - 12d0 , 2 9d0 , 3 7d0 
GD_SRS_FF_OPTIO_T_LIM = - 3 3d0 , - 3 OdO , 3 ldO , 3 9d0 
GD_PRTFBOXC29_T_LIM = - 2 8dO , - 2 5d0 , 3 ldO , 3 9d0 
GD_F 1 FAB C30_T_LIM = - 17d0 , - 12d0 , 2 5d0 , 33d0 
GD_F2 FABC3 1_T_L IM = - 17d0 , - 12d0 , 2 5d0 , 33d0 
GDF1LTRCRSC32_T_LIM = - lldO , - 6d0 , 3 ldO , 3 9d0 
GDF2LTRCRSC33_T_LIM = - lldO , - 6d0 , 3 ldO , 3 9d0 
GD_S R S PARC 3 4 _T_L I M = - 33d0 , -2 8d0 , 3 ldO , 3 9d0 
GD_PRTCALLC3 5_T_LIM = - 5 . 5d0 , -2 . ldO , - 0 . 9d0 , 2 . 5d0 
GD_PRTCALHC3 6_T_LIM = 41 . 7d0 , 45 . ldO , 46 . 3d0 , 49 . 7d0 
GD_PDBIASC3 8_V_LIM = 17d0 , 45d0 , 47d0 , 57d0 
GDAD1HSRAMC3 9_T_LIM = - 3 3d0 , - 2 8d0 , 6 OdO , 78d0 
GD_TCMBDC8_T_LIM = - 18 . OdO , - 10 . OdO , 55 . OdO , 65 . OdO 
#################################################### 

# AP23 Red Low, Yellow Low, Yellow High, Red High 
################################################### 
GD_LSM1_T_LIM = -30d0 , -25dO , 55d0 , 85d0 
GD_LSM2_T_LIM = -30d0 , -25dO , 55d0 , 85d0 

GD_AD SM_T_L I M = - 3 OdO , - 25dO , 8 5d0 , 9 OdO 
GD_LBSME_T_LIM = - 3 OdO , - 2 5d0 , 3 5d0 , 4 OdO 
GD_LBSMM_T_LIM = - 3 OdO , - 2 5d0 , 2 5dO , 3 OdO 
GD_H0P1ACTH1_C_LIM = - 0 . OldO , - 0 . 0 05d0 , 0 . 0 05d0 , 0 . OldO 
GD_H0P1ACTH2_C_LIM = - 0 . OldO , - 0 . 0 05d0 , 0 . 0 05d0 , 0 . OldO 
GD_H0P2ACTH1_C_LIM = - 0 . OldO ,- 0 . 0 05d0 , 0 . 0 05d0 , 0 . OldO 
GD_HOP2ACTH2_C_LIM = - 0 . OldO 0 . 0 05d0 , 0 . 0 05d0 , 0 . OldO 
GD_H0P3ACTH1_C_LIM = - 0 . OldO , - 0 . 0 05d0 , 0 . 0 05d0 , 0 . OldO 
GD_HOP3ACTH2_C_LIM = - 0 . OldO 0 . 0 05d0 , 0 . 0 05d0 , 0 . OldO 
##################################################### 

# AP50 Red Low, Yellow Low, Yellow High, Red High 
#################################################### 
GD_TSPMIR_T_LIM = - 15dO , - 5d0 , 2 5d0 , 3 OdO 
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GD_TSTWR_T_LIM = - 15d0 , - 5d0 , 2 5d0 , 3 OdO 
GD_ETC37D_T_LIM = 18d0 , 29d0 , 55d0 , 59d0 
GD_LHP1C37E_T_LIM = - 2d0 , OdO , 3 OdO , 32d0 
GD_LHP2C3 7F_T_LIM = - lOdO , - 8d0 , 22d0 , 24d0 
GD_TSPMIRHDR_C_LIM = - 0 . 2d0 , - 0 . ldO , 0 . 6 ldO , 0 . 62d0 
GD_TS TWRHDR_C_L I M = - 0 . 2d0 , - 0 . ldO , 0 . 5 9d0 , 0 . 63d0 
GD_ETHTRC3 7 J_C_LIM = - 0 . 2d0 , - 0 . ldO , 0 . 4dO , 0 . 5d0 
GD_DL YL I NEALL_T_L I M = - 12d0 , - 5d0 , 3 OdO , 3 3d0 
GD_DL YL I NEM I D_T_L I M = - 12d0 , - 2 . 5d0 , 14 . 5d0 , 3 3d0 
GD_DLYLINEHI_T_LIM = - 12d0 , 13 . 3d0 , 3 OdO , 3 3d0 
################################################## 

# Constant for Delay Waveform Offset (30 counts) 

# Used in QAP03 

################################################# 

GI_DC_OFFSET =30 

# 

# 28V Bus A Instrument (Volts) 

# 

GD_BA2 8 INST_SF = O.OdO, 9.22d0, O.OdO, O.OdO, O.OdO, 0 . OdO 

# 

# Hybrid Supplies (Amps) 

# 

GD_HYBSUPP_SF = O.OdO, 1 . 9d0 , O.OdO, O.OdO, O.OdO, O.OdO 

# 

# HVPS Detector Supplies (Amps ) 

# 

GD_HVPSDET_SF = O.OdO, 0.405d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# Operational Heaters (Amps) 

# 

GD_OPHTRS_SF = O.OdO, 0.395d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# Mechanical System (Amps) 

# 

GD_MECHSYS_SF = O.OdO, 0.395d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 28V Bus B Laser 1 (Volts) 

# 

GD_BB28L1V_SF = O.OdO, 9.35d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 28V Bus B Laser 1 (Amps) 

# 

GD_BB28L1A_SF = O.OdO, 1.551d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 28V Bus C Laser 2 (Volts) 

# 

GD_BC28L2V_SF = O.OdO, 9.35d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 28V Bus C Laser 2 (Amps) 

# 

GD_BC2 8L2A_SF = O.OdO, 1.511d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 28V Bus D Laser 3 (Volts) 

# 

GD_BD 2 8 L 3 V_S F = O.OdO, 9.35d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 28V Bus D Laser 3 (Amps) 

# 

GD_BD2 8L3A_SF = O.OdO, 1.555d0, O.OdO, O.OdO, O.OdO, O.OdO 


March 2013 


Page B-19 


Version 7.0 



The GLAS Science Algorithm Software (GSAS) User’s Guide 


ANC07 Format, Files and Contents 


# 

# 5V Hybrid #1 (Volts) 

# 

GD_5VHYB1V_SF = O.OdO, 1.54d0, O.OdO, O.OdO, O.OdO, 0 . OdO 

# 

# 5V Hybrid #1 (Amps) 

# 

GD_5VHYB1A_SF = O.OdO, 1.91d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 12V Hybrid #2 (Volts) 

# 

GD_12VHYB2V_SF = O.OdO, 3.52d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 12V Hybrid #2 (Amps) 

# 

GD_12VHYB2A_SF = O.OdO, 0.66d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# ml2V Hybrid #3 (Volts) 

# 

GD_M12VHYB3V_SF = O.OdO, -3.52d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# ml2V Hybrid #3 (Amps) 

# 

GD_M12VHYB3A_SF = O.OdO, 0.63d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 5V Hybrid #4 (Volts) 

# 

GD_5VHYB4V_SF = O.OdO, 1.532d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 5V Hybrid #4 (Amps) 

# 

GD_5VHYB4A_SF = O.OdO, 1.91d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# m5V Hybrid #5 (Volts) 

# 

GD_M5VHYB5V_SF = O.OdO, -1.532d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# m5V Hybrid #5 (Amps) 

# 

GD_M5VHYB5A_SF = O.OdO, 1.91d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# m5V Hybrid #6 (Volts) 

# 

GD_M5VHYB6V_SF = O.OdO, -1.532d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# m5V Hybrid #6 (Amps) 

# 

GD_M5VHYB6A_SF = O.OdO, 1.95d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 15V Boost Post Reg (Volts) 

# 

GD_15VBPR_SF = O.OdO, 4.08d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# ml5V Boost Post Reg (Volts) 

# 

GD_M 1 5 VB P R_S F = O.OdO, -4.09d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# 12V Prim Osc Thermal Control (Amps) 

# 
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GD_1 2 VPOTC_S F = O.OdO, 0.04d0, O.OdO, O.OdO, O.OdO, 0 . OdO 

# 

# 12V Sec Osc Thermal Control (Amps) 

# 

GD_12VSOTC_SF = O.OdO, 0.04d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# m2V Discrete Voltage (Volts) 

# 

GD_M2VDV_SF = O.OdO, 2. OdO, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# Hybrid Heatsink (deg C) 

# 

GD_HBHS_SF = O.OdO, 30.2d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# FET Switch Bank Heatsink (deg C) 

# 

GD_FETSBHS_S F = O.OdO, 3 0.2d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# HVPS OV Reference (Volts) 

# 

GD_HVPSOVR_SF = O.OdO, 0.0195d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# HVPS 5V Reference (Volts) 

# 

GD_HVPS 5 VR_S F = O.OdO, 0.03 91d0, O.OdO, O.OdO, O.OdO, O.OdO 

# 

# Number of bad lidar values within profile that will generate error 

# 

gi_bad_lid_num = 100 

# 

# Number of bins to average over for background (4 ) 

# 

gi_bg_bin = 8 

# 

# 1064 amplifier gain 

# 

gd_ir_gain = 18. OdO 

# 

# 1064 volts per count conversion (Volts/cnt) 

# 

gd_volts_cnt = 0.01560d0 

# 

# 1064 voltage offset 

# 

gd_volt_of f set = 0.840d0 

# 

# 1064 detector responsivity factor (Volts/Watt) 

# 

gd_det_res_f tr = 4.4d7 

## moved to const_glob_mod LAR030617 

## 1064 Basic time interval - nominally 1 ns 

## 

##d_dthires = 1 . OdO 

## 

## Threshold for computing the received and transmit energy from waveform peak 

## 

##d_thrpcnt = 0.03d0 

# 

# PRAP Siru Time Tag 
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# 

gd_siru_ttag= O.OdO, 64 . OdO 

# 

# PRAP Siru Integrated Angles 

# 

gd_siru_ia= O.OdO, 0 . 05d0 

# 

# PRAP Star Tracker #1 Data Latency 

# 

gd_bstl_datalat = O.OdO, 0 . 064d0 

# 

# PRAP Star Tracker #1 Position X 

# 

gd_bstl_posx = O.OdO, 0 . 5d0 

# 

# PRAP Star Tracker #1 Position Y 

# 

gd_bstl_posy = O.OdO, 0 . 5d0 

# 

# PRAP Star Tracker #1 Intensity 

# 

gd_bstl_starint = O.OdO, 0.0625d0 

# 

# PRAP Star Tracker #1 CCD Temperature 

# 

gd_bstl_ccdtemp = O.OdO, 0 . OldO 

# 

# PRAP Star Tracker #1 Baseplate Temperature 

# 

gd_bstl_bptemp = O.OdO, O.OldO 

# 

# PRAP Star Tracker #1 Lens Temperature 

# 

gd_bstl_lenstemp = O.OdO, O.OldO 

# 

# PRAP Star Tracker #1 8v 

# 

gd_bstl_8v=0 . OdO , 0 . ldO 

# 

# PRAP Star Tracker #1 -9v 

# 

gd_bstl_n9v=0 . OdO , 0 . ldO 

# 

# PRAP Star Tracker #1 4v 

# 

gd_bstl_4v=0 . OdO , 0 . ldO 

# 

# PRAP Star Tracker #1 -5v 

# 

gd_bstl_n5v=0 . OdO , 0 . ldO 

# 

# PRAP Star Tracker #2 Data Latency 

# 

gd_bst2_datalat = O.OdO, 0 . 064d0 

# 

# PRAP Star Tracker #2 Position X 

# 

gd_bst2_posx = O.OdO, 0 . 5d0 

# 
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# PRAP Star Tracker #2 Position Y 

# 

gd_bst2_posy = O.OdO, 0 . 5d0 

# 

# PRAP Star Tracker #2 Intensity 

# 

gd_bst2_starint = O.OdO, 0.0625d0 

# 

# PRAP Star Tracker #2 CCD Temperature 

# 

gd_bst2_ccdtemp = O.OdO, 0 . OldO 

# 

# PRAP Star Tracker #2 Baseplate Temperature 

# 

gd_bst2 bptemp = O.OdO, O.OldO 

# 

# PRAP Star Tracker #2 Lens Temperature 

# 

gd_bst2_lenstemp = O.OdO, O.OldO 

# 

# PRAP Star Tracker #2 8v 

# 

gd_bst2_8v=0 . OdO , 0 . ldO 

# 

# PRAP Star Tracker #2 -9v 

# 

gd_bst2_n9v=0 . OdO , 0 . ldO 

# 

# PRAP Star Tracker #2 4v 

# 

gd_bst2_4v=0 . OdO , 0 . ldO 

# 

# PRAP Star Tracker #2 -5v 

# 

gd_bst2_n5v=0 . OdO , 0 . ldO 

# 

# PRAP 1ST Virtual Tracker Boresight H 

# 

gd_ist_boreh=0 . OdO , 412529. 72d0 

# 

# PRAP 1ST Virtual Tracker Boresight V 

# 

gd_ist_borev=0 . OdO , 412529. 72d0 

# 

# PRAP 1ST Virtual Tracker Focal Length 

# 

gd_ist_f oclngth=0 . OdO , 1 . OdO 

# 

# PRAP 1ST Virtual Tracker Time to Center of Integration 

# 

gd_ist_timcof int=0 . OdO , 20. OdO 

# 

# PRAP LRS Time to Center of Integration 

# 

gd_lrs_timcof int=0 . OdO , 20. OdO 

# 

# PRAP 1ST Virtual Tracker Star Magnitude 

# 

gd_ist_VTstarmag=0 . OdO , 0 . ldO 
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# 

# PRAP 1ST Boresight Column 

# 

gd_ist_borecol=256 . OdO , 0 . 001953d0 

# 

# PRAP 1ST Boresight Row 

# 

gd_ist_borerow=256 . OdO , 0 . 001953d0 

# 

# PRAP 1ST CCD Temperature 

# 

gd_ist_ccdtemp=-273 . 16d0 , 0 . 007812d0 

# 

# PRAP 1ST Lens Cell Temperature 

# 

gd_ist_lenscellt=-273 .16d0,0.007812d0 

# 

# PRAP LRS Virtual Tracker 0 Centroid Row 

# 

gd_lrs_VTcentr=0 . OdO, 0 . 02646875d0 

# 

# PRAP LRS Virtual Tracker 0 Centroid Column 

# 

gd_lrs_VTcentc=0 . OdO, 0 . 02646875d0 

# 

# PRAP LRS Integration Time 

# 

gd_lrs_inttime=0 . dOO , 1 . OdO 

# 

# PRAP LRS Health CCD Temperature 

# 

gd_lrs_hlth_ccdtemp=-273 . 16 , 0.007812 

# 

# PRAP LRS Health Lens Cell Temperature 

# 

gd_lrs_hlth_celltemp=-273 . 16 , 0 . 007812 

# 

# PRAP ADCS Attitude Q1 

# 

gd_adcs_att_ql=0 . OdO , 3 . 2d-5 

# 

# PRAP ADCS Attitude Q2 

# 

gd_adcs_att_q2=0 . OdO , 3 . 2d-5 

# 

# PRAP ADCS Attitude Q3 

# 

gd_adcs_att_q3=0 . OdO , 3 . 2d-5 

# 

# PRAP ADCS Attitude Q4 

# 

gd_adcs_att_q4=0 . OdO , 3 . 2d-5 

# 

# PRAP ADCS Orbital Pos X 

# 

gd_adcs_pos_x=0 . OdO , 0 . 25d0 

# 

# PRAP ADCS Orbital Pos Y 

# 
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gd_adcs_pos_y=0 . OdO , 0 . 25d0 

# 

# PRAP ADCS Orbital Pos Y 

# 

gd_adcs_pos_z=0 . OdO , 0 . 25d0 

# 

# PRAP ADCS Orbital Vel X 

# 

gd_adcs_vel_x=0 . OdO , 3.2d-4 

# 

# PRAP ADCS Orbital Vel Y 

# 

gd_adcs_vel_y=0 . OdO , 3.2d-4 

# 

# PRAP ADCS Orbital Vel Z 

# 

gd_adcs_vel_z=0 . OdO , 3.2d-4 

# 

# PRAP ADCS Calculated SA 1 Position 

# 

gd_adcs_cal_posl=0 . OdO , 2 . Od-4 

# 

# PRAP ADCS Calculated SA 2 Position 

# 

gd_adcs_cal_pos2=0 . OdO , 2 . Od-4 

# 

# Quality Assurance dumping intervals [seconds] 

# 

I_QA0 1_DUMP_TME =16 
I_QA0 2_DUMP_TME = 16 
I_QA03_DUMP_TME = 3600 
# 

# Quality Assurance energy histogram interval [joules] 

# 

D_QA_ G _N RG _ H 1ST = O.OOOdO, O.OOldO, 0.002d0, 0.003d0, 0.004d0, 0.005d0, 0.006d0, 

0 . 007d0 , 0 . 008d0 , 0.009d0, O.OlOdO, O.OlldO, 0.012d0, 0.013d0, 0.014d0, 0.015d0 

D_QA_IR_NR G _HI ST = O.OOOdO, 0.004d0, 0.008d0, 0.012d0, 0.016d0, 0.020d0, 0.024d0, 

0 . 028d0 , 0 . 032d0 , 0.036d0, 0.040d0, 0.044d0, 0.048d0, 0.052d0, 0.056d0, 0.060d0 

# 

# 

END_0F_L1A = 

# 

END OF ANC07 FILE = 


B.3.3 Waveform Constants 


# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 


Waveform Constants Mod Entries 


2003 Feb 10 Jack L. Saba Mantis 1228: added d_ G ainAlertLevel . 

2004-04-13 LA. Roberts, changed I_SATAMP, I_SATUR_ G AIN, D_SATUR_NR G , 

D_MINNR G _SAT , I_MAXG!AIN_SAT , D_WIDTHPK_SAT , & D_M INS KEW_SAT to arrays of 3 
2004-05-07 LA. Roberts, added D_MINSI G WDTH and D_MINPK2NS 
2004-07-12 LA. Roberts, added D_NSICTX 

2004- 11-05 LA. Roberts, added D_DPROXl, D_DPROX2 , I_ESTSW1 & I_ESTSW2 

2005- 02-09 LARoberts, added I_SATNDXTH 

2005-04-06 LARoberts, changed D_AREATELE , mantis 1750 

2005-04-13 LARoberts, added d_f ltrWdMinl , d f ltrWdMin2 , d_wf FitSDevThr 
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# i_normWF & i_convSw 

# 2005-06-24 LARoberts, added I_TMCKSW1 & I_TMCKSW2 (cr2034) 

# 2005-08-26 LARoberts, added d_maxSDev (cr2091) 

# 2005-08-17 LARoberts, changed D_FLTRWDMIN1 , D_INTV_MIN1 & D_WT_SGM 

# per mantis 2078 

# 2005-08-31 LARoberts, changed D_FLTRWDMIN1 & D_INTV_MIN1 per new 

# requirements in mantis 2078 

# 2005-09-14 LARoberts, added IJSTORMTYPE 

# 2005-09-16 LARoberts, added iMinNG2useTr & iNGates2useTr 

# 2005-10-06 LARoberts, changed D_WT_SGM to D_WT_SGM1 & D_WT_SGM2 (cr2128) 

# 2005-11-15 LARoberts, added i_maxNdxNSatl & i_maxNdxNSat2 

# 2005-12-21 LARoberts, added IJ3T0PAT6_1 & I_STOPAT6_2 (cr2206) 

# 2006-01-20 LARoberts, added i_throwOutZAl & i_throwOutZA2 , and changed 

# D_WFFITSDEVTHR1 from 0.00001 to 0.001 

# 2006-01-25 JLee, Change i_maxNdxNSat2 to 0 


# 

2006-03-31 

LARoberts 

, (2266) 

/ 

changed d nSig to 

d beg nsig 

and 

LAR0 6 0331 

# 

d end nsig 






LAR0 6 0331 

# 

2006-01-31 

LARoberts 

, added 

d_ 

maxDeltas (2220) 




# 

2006-02-23 

LARoberts 

, added 

I_ 

_MAXSMBINS (2236) 




# 

2006-06-09 

LARoberts 

, added 

I 

_KEEPPK1 (2322) 



LAR0 6 0609 

# 

2006-07-19 

LARoberts 

, added 

I 

_MIN4CLI P (2339) 



LAR0 6 0719 

# 

2006-07-24 

LARoberts 

, added 

comments and changed values of 

I_ESTSW1 


# 

and I_MAXNDXNSAT1 ( 

2326) 






# 

2006-07-26 

LARoberts 

, removed 

d_minskew_sat , i_ 

maxgain sat, 


LAR0 6 0726 

# 

d minnrg 

sat, & d_ 

satur nrg 

from anc07 Indep . 

(2263) 


LAR0 6 0726 

# 

2006-08-11 

LARoberts 

, changed 

I_STOPAT6_l , D_FLTRWDMIN1 , D_BEG_NSIG1 , 



# D_MAXDELTAS_A1 & D_MAXDELTAS_L1 per 2362 

# 2006-08-17 LARoberts, changed D_MAXDELTAS_A1 per 2367 

# 2006-08-30 LARoberts, changed D_FLTRWDMIN1 & D_FLTRWDMIN2 to 

# D_FLTRWDBEG1 & D_FLTRWDBEG2 and removed D_WIDTHPK_SAT and I_SATAMPn 

# 2006-11-03 LARoberts, changed D_MAXGOODSDEV to D_MAXGOODSDEVl and 

# D_MAXG00DSDEV2 , and changed D_MAXG00DSDEV1 from 0.04 to 0.06 (2416 & 2420) 

# 2008-01-07 LARoberts, added BSS calibration vars, D_OVRCALIB & D_NLGC 

# 2008-02-26 LARoberts, added IMINSATNDX (2356) 

# 2007-08-03 LARoberts, changed d_GainAlertLevel to i_GainAlertLevel (2506) 

# 2009-06-02 LARoberts, implemented time dependent d_nSig (2864) 

# 2009-06-09 LARoberts, removed unused vars: I_USEHS_PROC , D_AALPHA, (2895) 

# D_AGAMA , D_ABETA, I_SATUR_GAIN* , D_AREAV 0 

# 2009-07-17 LARoberts, changed D_MAXDELTAS_S1 , D_MAXDELTAS_A2 , 

# D_MAXDELTAS_L2,D_MAXDELTAS_S2 (2764) 

# 2009-07-23 LARoberts, updated BSS table for L2D & L2E (2862) 

# 2009-08-02 Jlee, updated NSIG table values and reordered. 

# 2010-06-10 LARoberts, changed BSS table for L2D, L2E, & L2F from (2903) 

# 1.23 to 1.70 

# 2011-03-08 LARoberts, Changed entry#4 of D_N S I G_TAB L E from time 

# 280900000 to 244631000 (3051) 

# 

BEG_OF_WF = 

WF_VERS = ANC07 WF V6 . 0 2011-03-08 

# 

# Select Region "0==use all gates, l==use selected region" 

I_SLCTREGN1 = 1 

I_SLCTREGN2 = 0 

# 

# "If i_slctRegn? is set, indexSignalBegin? = indexSignalBegin? - i_offsetb?" 
I_0FFSETB1 = 50 

I_OFFSETB2 = 50 

# 

# "If i_slctRegn? is set, indexSignalEnd? = indexSignalEnd? + i_offsete?" 
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I_OFFSETEl = 50 
I_OFFSETE2 = 50 
# 

# Min # of gates equal to 255 to set the clipped flag in l_WFqual 
I_MIN4CLIP=2 

# 

# Min number of iterations during functional fit 
I_MINITER = 3 

# 

# Max number of iterations during functional fit 
I_MAXITER1 = 12 

I_MAXITER2 = 12 

# 

# Max number of peaks to fit - alternate & standard parameters 
I_MAXFIT1 = 6 

I_MAXFIT2 = 2 

# 

# Min filter width used by WFMgr for sanity checking 
D_FLTRWDM I N =4 . OdO 

# 

# Min filter width used by W_Smoothl 

# D_FLTRWDBEG1 is the two sigma filter used to make the alt smoothed WF 

# D_FLTRWDBEG2 is the two sigma filter used to make the std smoothed WF 

# both smoothed WFs are passed to W_FunctionalFt & used for estimates. 
D_FLTRWDBEG1 =14 . OdO 

D_FLTRWDBEG2 =33. OdO 
D_FLTRWDMAX = 12 9. OdO 

# max num bins to use for smoothing in W_Smoothl 
I_MAXSMBINS =129 

# 

# Absolute minimum amplitude (volts) 

D^ABSMINAMPl = 0.05d0 
D_ABSMINAMP2 = 0.05d0 

# 

# Min peak amplitude = d_Npeak_min? * (sDevNoise)+ noise 
D_NPEAK_MIN1 = 4 . 5d0 

D_NPEAK_MIN2 = 4 . 5d0 

# 

# Max peak amplitude (volts) 

D_MAXAMP = 2 . 5d0 

# 

# Min & max peak sigma (ns) 

D_SIGMAMINIT = 2 . 5d0 
D_MAX SIGMA = 300. OdO 

# 

# Max value for d_wfFitSDev and d_sDevFitTr 
D_MAXSDEV = 0.3 dO 

# 

# Noise threshhold TransPulse = d_nsigTx * sDevNsTx 
D_NSIGTX = 1 . 5d0 

# 

# 


# 

D_T_NSIG 

YYYYMMDD 

HHMMSS 


# 

000000000 . OdO 

20030220 

000000 

L1A 

# 

117782220 . OdO 

20030925 

171700 

L2A 

# 

130326180 . OdO 

20040217 

214300 

L2B 

# 

138171420 . OdO 

20040518 

165700 

L2C 

# 

150111000 . OdO 

20041003 

213000 

L3A 

# 

161928480 . OdO 

20050217 

160800 

L3B 
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# 169878900 . OdO 20050520 163500 L3C 

# 183207360 . OdO 20051021 225600 L3D 

# 193912620 . OdO 20060222 203700 L3E 

# 201764580 . OdO 20060524 174300 L3F 

# 215052540 . OdO 20061025 124900 L3G 

# 226937100 . OdO 20070312 020500 L3H 

# 244631400 . OdO 20071002 211000 L3I 

# 256549920 . OdO 20080217 195200 L3J 

# 276401580 . OdO 20081004 141300 L3K 

# 280907280 . OdO 20081125 174800 L2D 

# 289879560 . OdO 20090309 140600 L2E 

# 

# Noise threshhold = d_nsig? * sDevNoise 

# 

# NSIG Table Fields: 

# 

G I _NUM_N S I G = 8 

# 

# Table History 

# 

# 7/31/2009 Change Std fit Nsig to 9.5 for L2C 5/17/2004 to 6/22/2004 

# 7/31/2009 Change std fit Nsig to 15 for L3A to L3G 

# 7/31/2009 Change Std fit Nsig to 9.5 for L3G and all periods afterward 

# 10/24/2006 table end 

# 7/31/2009 Change Alt fit Nsig to 7.5 for L2E 3/8/2009 table end 

# 2011-03-03 Changed entry#4 from time 280900000 to 244631000 

# 

# TIME B_NSIG1 E_NSIG1 B_NSIG2 E_NSIG2 

# 


D_ 

_NSIG_ 

_TABLE = 

000000000 . OdO 

3 . 5D0 

4 . 5D0 

15 . ODO 

15 . ODO 

D_ 

_NSIG_ 

_TABLE = 

138024000 . OdO 

3 . 5D0 

4 . 5D0 

15 . ODO 

15 . ODO 

D_ 

_NSIG_ 

/TABLE = 

141134400 . OdO 

3 . 5D0 

4 . 5D0 

15 . ODO 

15 . ODO 

D_ 

_NSIG_ 

_TABLE = 

244631000 . OdO 

3 . 5D0 

4 . 5D0 

9 . 5D0 

9 . 5D0 

D_ 

_NSIG_ 

_TABLE = 

289742400 . OdO 

7 . 5D0 

7 . 5D0 

9 . 5D0 

9 . 5D0 

D_ 

_NSIG_ 

_TABLE = 

999999999 . OdO 

7 . 5D0 

7 . 5D0 

9 . 5D0 

9 . 5D0 

D_ 

_NSIG_ 

_TABLE = 

999999999 . OdO 

7 . 5D0 

7 . 5D0 

9 . 5D0 

9 . 5D0 

D 

NSIG 

TABLE = 

999999999 . OdO 

7 . 5D0 

7 . 5D0 

9 . 5D0 

9 . 5D0 


# 

# Min interval between peaks 
D_ I NTV_M INI = 15. OdO 

D_ I NTV_M I N2 = 30. OdO 

# 

# fraction of peak sigma proximity to sigB or sigE allowed during fit 
D_DPROXl = 0 . OdO 

D_DPROX2 = 0.2 5 dO 

# 

# l=don't remove peaks if too small, too narrow, or too close. 
I_KEEPALLPKS1 = 1 

I_KEEPALLPKS2 = 0 

# 

# l=remove peaks if zero amplitude and if I_KEEPALLPKSn == 1 
I_THROWOUTZAl = 1 

I_THROWOUTZA2 = 0 

# 

# d_maxDeltas = max delta during fit 

# _N multiply by noise parm 

# _A multiply by amplitude parm 

# _L absolute number for max loc delta in ns 

# _S multiply by sigma parm 
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D_MAXDELTAS_N1 = 0 . OdO 
D_MAXDELTAS_A1 = 0 . 5d0 
D_MAXDELTAS_L 1 = 15. OdO 
D_MAXDELTAS_S1 = 0 . 5d0 
# 

D_MAXDELTAS_N2 = 0 . OdO 
D_MAXDELTAS_A2 = 0 . 5d0 
D_MAXDELTAS_L2 = 15. OdO 
D_MAXDELTAS_S2 = 0 . 5d0 
#D_MAXDELTAS_A2 = 10000. OdO 
#D_MAXDELTAS_L2 = 10000. OdO 
#D_MAXDELTAS_S2 = 10000. OdO 
# 

# Switch used during estimates (for secondary peaks) 

# 0=Recompute peak sigmas 

# l=Do not recompute sigmas 

#The loop is going from the largest area to the smallest. 

# If i_estswN=l, then it only does the highest ranking peak (largest area) . 

# If i_estswN=0, then it recomputes the sigma for all of the peaks. 

#When the sigma is recomputed, instead of computing the sigma from the second 

# derivative, the locations to either side of the peak location are found 

# where the amplitude is a percentage of the peak amplitude: 

# At T where W = 80% AMPm, |T-Tm| = 0.668045 * SGMm . 

# so, find T1 before Tm and T2 after Tm where W = 80% AMPm 

# SGMm = | dT2_80 - dTl_80| / 1.33609d0 

# At T where W = 60.653% AMPm, |T-Tm| = SGMm. 

# so, find T1 before Tm and T2 after Tm where W = 60.653% AMPm 

# SGMm = | dT2_61 - dTl_6l| / 2 . OdO 
I_ESTSW1 = 0 

I_ESTSW2 = 1 

# 

# Combine peaks switch 

# "(0,1) => weight peaks by area when combining" 

# "(1,0) => use straight average when combining peaks" 

D_CMB 1 = O.OdO 

D_CMB2 = 1 . OdO 

# 

# min signal width for a good fit 

# if sigE-sigB < this value, l_WFqual (gwi_suspect , iWF) is set 
D_MINSIGWDTH = 5 . OdO 

# 

# min peak to noise ratio for a good fit 

# if (maxAmp-d_bgNoiseOb) /d_sDevNsOb < this value, 

# l_WFqual (gwi_suspect , iWF) is set 
D_MINPK2NS = 5 . OdO 

# 

# max value of standard deviation of fit for a good fit 

# if d_wf FitSDev ( iWF , ? ) > this value, l_WFqual (gwi_poorFit? , iWF) is set 
D_MAXG00DSDEV1 = 0.0 6d0 

D_MAXGOODSDEV2 = 0 . 04d0 

# 

# chi threshold for convergenge of fit in W_CkConvRMS 

# when sDevFit changes by <= this value during an iteration of the fit, 

# then the fit has converged 
D_WFFITSDEVTHR1 = O.OOldO 
D_WFFITSDEVTHR2 = O.OOOOldO 

# 

# Switch to normalize WF during fit 

# 0 => don't normalize 
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# 1 => normalize 
I_N0RMWF1 = 1 
I_NORMWF2 = 0 

# 

# Switch to convergence method 

# 0 => use W_CkConv (parameter change) 

# 1 => use W_CkConvRMS (chi change) 

I_C0NVSW1 = 1 

I_C0NVSW2 = 0 

# 

# Iterated parameter change indicating convergence in W_CkConv 

# 0.02 == 2% or less change => convergence 
D_DN0ISE1 = 0 . 02d0 

D_DN0ISE2 = 0 . 02d0 

# 

D_DAMPCK1 = 0 . 02d0 
D_DAMPCK2 = 0 . 02d0 
# 

D_DTMCK1 = 0.0 2 dO 
D_DTMCK2 = 0.0 7 dO 
# 

D_DSGMCK1 = 0 . 02d0 
D_DSGMCK2 = 0 . 02d0 
# 

# Switches 

# l==use D_DTMCK as a number of ns 

# 0==use D_DTMCK as percent for W_CkConv 

# 

I_TMCKSW1 = 0 
I_TMCKSW2 = 1 
# 

# Calculate noise switch 

# "0==use observed noise & sDevNoise, l==calculate noise & sDevNoise" 
I_NSCAL1 = 0 

I_NSCAL2 = 0 

# 

# Number of gates to use to calculate noise (beginning & ending of WF) 
INGATES2USE1 =20 

INGATES 2USE2 =20 

# 

# Min number of gates to use to calculate noise (in case signal_begin or 

# signal_end occurs within INGATES2USE? gates of the beginning or ending 

# of the WF) 

IMINNG2USE =10 

# 

# Number of gates to use to calculate noise for the transmitted pulse 
INGATES 2USETR =10 

# 

# Min number of gates to use to calculate noise for the transmitted pulse 
IMINNG2USETR = 5 

# 

# Min i_satNdx to be counted as saturated for QA purposes 
IMINSATNDX = 2 

# 

# 

# Threshold for saturation index. If the gate amplitude is >= 

# this value, then i_satNdx is incremented (max value is 126) . 

# -- changed to array of 256 per mantis 2324 
#1 SATNDXTH = 220 
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I _SAT_TH_ 1 = 30, 30, 30, 30, 30, 30, 30, 30,109,149,177,196,209,218,224,228 
I _SAT_ TH _2 = 231,232,233,234,234,234,235,235,236,237,238,239,239,239,239,239 
I_SAT_TH_3 = 239,239,239,239,239,239,239,239,239,239,239,239,239,239,239,239 
I_SAT_TH_4 = 239,239,239,239,239,239,239,239,239,239,239,239,239,239,239,239 
I_SAT_TH_5 = 239,239,239,239,239,239,239,239,239,239,239,239,239,239,239,239 
I_SAT_TH_6 = 239,239,239,239,239,239,239,239,239,239,239,239,239,239,239,239 
I_SAT_TH_7 = 239,239,239,239,239,239,239,239,239,239,239,239,239,239,239,239 
I_SAT_TH_8 = 239,239,239,239,239,239,239,239,239,239,239,239,239,239,239,239 
I _ SAT _ TH _ 9 = 239,239,239,239,239,239,239,239,239,239,239,239,239,239,239,239 
I _SAT_T H __ 1 0=2 3 9, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239 
i _SAT_TH_ 11 =2 3 9, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239 
I _SAT_TH_ 1 2=2 3 9, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239 
I _SAT_TH_ 1 3 =2 3 9, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239 
I_SAT_TH_i4=2 3 9, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239 
I _SAT_TH_i5=2 3 9, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239 
I_SAT_TH_ 1 6=2 3 9, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239, 239 
# 

# Used in W_Estimates and W_EstNew. If I_SATNDX <= this value, then 

# Sigma is not recal 1 d as if the whole signal was one saturated peak 
I_MAXNDXNSAT1 =20 

I_MAXNDXNSAT2 = 0 

# 

# Used in W_Estimates and W_EstNew. If I_stopat6_l=l then stop combining 

# peaks in spite of being close to other peaks if 6 or less 
I_STOPAT6_l = 0 

I_STOPAT6_2 = 0 

# 

# Used in W_Estimates and W_EstNew. If i_keepPkl_l=l then keep peak #1 

# even if its rank is more than i_maxfit 
I_KEEPPK1_1 = 1 

I_KEEPPK1_2 = 0 

# 

# non-linear gain calibration for reflectivity 

# Y=NLGC (1) +NLGC (2) *gain+NLGC ( 3 ) *gain A 2+NLGC (4) *gain^3+NLGC ( 5 ) *gain"4 

# f = 1 / Y 

# E__norm = f * E 

# 

D_NLGC = 0 . 72807d0 , 0.008543d0, -9.6905d-5, 4.7896d-7, -8.621d-10 

# 

# BSS (Boresight Shift Shadowing) 

# 

# D_T_BSS YYYYMMDD HHMMSS D_F_BSS 

# 000000000 . OdO 20030220 000000 L1A l.OOdO 

# 117782220 . OdO 20030925 171700 L2A 1.83d0 

# 119340000 . OdO 20031013 180000 L2A 1 . 95d0 

# 119348940 . OdO 20031013 202900 L2A 1 . 15d0 

# 119443920 . OdO 20031014 225200 L2A 1.30d0 

# 120648000 . OdO 20031028 212000 L2A 1.55d0 

# 120735000 . OdO 20031029 213000 L2A 1.35d0 

# 130326180 . OdO 20040217 214300 L2B 1.30d0 

# 138171420 . OdO 20040518 165700 L2C 1.40d0 

# 138348060 . OdO 20040520 180100 L2C 1.23d0 

# 150111000 . OdO 20041003 213000 L3A l.OOdO 

# 161928480 . OdO 20050217 160800 L3B 0 . 95d0 

# 183207360 . OdO 20051021 225600 L3D l.OOdO 

# 256554496 . OdO 20080217 000000 L3J l.OOdO 

# 276405992 . OdO 20081004 000000 L3K l.OOdO 

# 280907280 . OdO 20081125 174800 L2D 1.23d0 -> 1 . 7d0 

# 289879560 . OdO 20090309 140600 L2E 1.23d0 -> 1 . 7d0 
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# 307623923 . OdO 20090930 000000 L2F 1.23d0 -> 1 . 7d0 

# 999999999. OdO l.OOdO 

# 

# number of actual values in table 
I_N_BSS = 15 

# 

# effective time 

D_T_BSS1 = 000000000 . 0d0, 117782220 . OdO , 119340000 . OdO , 119348940 . OdO 

D_T_BSS2 = 119443920 . OdO, 12 0 64 8 0 0 0 . OdO , 120735000 . OdO , 130326180 . OdO 

D_T_BSS3 = 138171420 . OdO, 138348060 . OdO , 150111000 . OdO , 161928480 . OdO 

D_T_BSS4 = 183207360 . OdO, 2 8 0 9 0 72 8 0 . OdO , 999999999 . OdO , 999999999 . OdO 

D_T_BSS5 = 999999999. OdO, 999999999 . OdO , 999999999 . OdO , 999999999 . OdO 

D_T_BSS6 = 999999999. OdO, 999999999 . OdO , 999999999 . OdO , 999999999 . OdO 

# 

# Calibration factor 

D_F_BSS1 = l.OOdO, 1 . 83d0 , 1.95d0, 1.15d0 
D_F_BSS2 = 1 . 30d0 , 1.55d0, 1.35d0, 1.30d0 
D_F_BSS3 = 1 . 40d0 , 1.23d0, l.OOdO, 0.95d0 
D_F_BSS4 = l.OOdO, 1 . 7 OdO , l.OOdO, l.OOdO 
D_F_BSS5 = l.OOdO, l.OOdO, l.OOdO, l.OOdO 
D_F_BSS6 = l.OOdO, l.OOdO, l.OOdO, l.OOdO 

# 

# Overall calibration for reflectivity 

# d_ovrCalib (2 ) ==1/1 . 16 
D_OVRCAL I B = O.OdO, 0 . 8 62 0 68 965d0 

# 

# retracker threshhold = d_thresh_lvl * maxSmoothAmp (WF) 

D_THRESH_LVL1 = O.lldO 

D_THRESH_LVL2 = 0.15d0 

# 

# Measurement uncertainty for computing weights for LsqFit 

# wt = 1/ (D_WT_SGM) a 2 
D_WT_SGM1 = 0 . 03d0 
D_WT_SGM2 = O.OOldO 

# 

# a priori fit-matrix-sigma for noise = 1/SQRT (d_V0ns ) 

D_V0NS1 = 1000000. OdO 

D_V0NS2 = 1000000. OdO 

# 

# a priori fit-matrix-sigma for amplitude = 1/SQRT (d_V0 amp) 

D_V0AMP1 = O.OOldO 

D_V0AMP2 = O.OOldO 

# 

# a priori fit-matrix-sigma for location = 1/SQRT (d_V01oc) 

D_VOLOC1 = 0 . IdO 

D_VOLOC2 = 0 . IdO 

# 

# a priori fit-matrix-sigma for peak-sigma = 1/SQRT (d_V0sgm) 

D_V0SGM1 = O.OOldO 

D_V0SGM2 = O.OOldO 

# 

# Minimum noise (raw counts) 

D_MINNOISE = 0 . 5d0 

# 

# Area of telescope ... changed from 0.709 to pi/4 LAR050406 

D_AREATELE = 0.78539816d0 

# 

# Optics transmission ... changed from .555 to .67 see mantis 671 LAR030818 

D OPTTRANS = 0.67d0 
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# 

# QA along-track dumping interval time [seconds] 

I _QA_DUMP_TME =16 

# 

# Set gain flag in i_ElvFlg = 1 if gain >= this value, = 0 otherwise 
i_GainAlertLevel = 30 

# 

# 

END_OF_WF = 

# 

END_OF_ANC07_FILE = 

B.3.4 Atmosphere Constants 

# 

# GLAS vl ANC07 Atmosphere File 

# 

# 1999 November 11 JLee, Fixed error codes, split out. 

# 2000 March 13 JLee, Updated. 

# 2000 March 16 JLee, fixed gi_cld_thick 

# 2000 April 17 KBarbieri - Modifications for VI integration 

# 2000 August 16 KBarbieri - Starting V2 additions 

# 2000 August 28 KBarbieri - changed cal cofs for lidar profile unit 

# change from J to mJ 

# 2000 Nov 13 KBarbieri - Adding atm_anc additions 

# 2001 Feb 09 KBarbieri - Adding LIB additions 

# 2001 May 02 KBarbieri - Adding L2 additions 

# 2001 Oct 22 KBarbieri - Changing version to V2 

# 2002 Jan 16 SPalm - Changed GI_CC_ELIM_F from 1 to 0 

# 2002 Jan 16 SPalm - Changed gd_g_bkgd_thr from 6 to 4 

# 2002 Jan 16 SPalm - Changed GI_CC_MFIT from 10 to -1 

# 2002 Feb 01 Spalm - Changed Cloud/Aerosol discrimination thresholds 

# 2002 Feb 01 SPalm - Changed GD_RAT_THR 1 from 1 . OdO to 1.0d-l 

# 2002 Feb 04 SPalm - Changed GI_GDET_BIN from 0 to 5 

# 2002 Apr 23 WHart - Changed GD_CLD_THR_FTR from 4 . OdO to 3 . OdO 

# 2002 Apr 23 WHart - Changed GI_RN_T0P from 23000 to 35000 

# 2002 Jun 17 KBarbieri - Added GD_TIME_TOL 

# 2003 Apr 24 Jlee - CR0000373 GD_IR_LMCALCOF , GI_USE_GCC_F , and 

# GI_USE_IRCC_F 

# 2003 May 09 SPalm - Changed GD_TIME_TOL form 1 . OdO to 1 . 0d2 

# 2003 Jul 25 SPalm - Changed GD_IR_LMCALCOF from 5 . 82dl to 5.20dl 

# 2003 Oct 24 Jlee - CR0000985 

# 2004 Jan 22 WDHART - Changed from GI_CALC_AER_F from 1 to 0 ; 

# 2004 Jan 29 SPalm - Changed GI_AER_TOP_HT from 36000 to 30000 

# 2004 Feb 04 SPalm - Changed GI_CC_ELIM_F from 1 to 0 

# 2004 Feb 20 SPalm - Changed GD_CRAT_THR2 0 from l.lOdl to 1 . Odl 

# 2004 Mar 22 SPalm - Changed GD_IR_LMCALCOF from 52.0 to 42.0 

# 2004 Mar 22 SPalm - Changed GD_PBLJTHR_FTR from 0.40 to 0.30 

# 2004 Mar 22 SPalm - Changed GI_CC_ELIM_F from 0 to 1 

# 2004 Mar 23 SPalm - Changed GD_CC_NUM_STD from 2 . OdO to 1 . 3d0 

# 2004 Mar 25 WHart - Updated GD_DISCRIM_THR profile 

# 2004 Jul 14 DHlavka - Updated GD_GDET_FTR from 5.0 to 9.0 

# 2004 Aug 26 SMcLaughlin- Add QA dumping intervals 

# 2005 Apr 25 SMcLaughlin- Add smoothing-filter half-widths 

# 2005 Jun 17 SMcLaughlin- Add threshold of integrated signal which 

# implies a cloud 

# 2005 Jun 27 SMcLaughlin- Add Low Clouds search Count Number Needed 

# for identification 

# 2007 Jun 08 SPalm - Changed GI_CAL_TIME from 600 to 1000 and GI_CC_ELIM_F 


March 2013 


Page B-33 


Version 7.0 



The GLAS Science Algorithm Software (GSAS) User’s Guide 


ANC07 Format, Files and Contents 


from 1 to 0 

# 2007 Jul 19 SPalm - The above did not work well for day-night transition. 

Integration time 

# was too long. Changed GI_CAL_TIME to 250 

# 2007 Jul 10 SPalm - Changed GD_H I _HAL F W I D from 2.0 to 4.0 - the 

calibration band half width. I also changed 

# the center height of the cal band from 22000 m 
to 25000 m (in const_atm_mod. f 90) 

# 2007 Sep 04 SPalm - Changed GD_D I URNAL_FTR from 0 . 5 to 1.463d-6 

# 2007 Oct 26 SPalm - Changed GD_D I URNAL_FTR from 1.463d-6 to 2.926d-6 

# 2007 Dec 11 SPalm - Changed GD_D I URNAL_FTR from 2.926d-6 to 4.38d-6 

# 

# ATM Constants Mod Entries 

# 

BEG_OF_ATM = 

ATM_VERS = ANC07 Atm Globals V6 . 0 Dec 11 2007 

# 

# Aerosol scaling factor for 20 sec search 

# It seems that 4.0 is good for daytime data, but 5.0 is better for night 

# 

GD_AER_2 0 S_FTR = 2 . 5d0 

# 

# Aerosol scaling factor for 4 sec search 

# 

GD_AER_4 S_FTR = 0.3d0 

# 

# Aerosol threshold factors for new (V2) molecular threshold at 20 sec 

# 

GD_AER_FTR1 = 3 . OdO 
GD_AER_FTR2 = 1.2d0 
GD_AER_FTR3 = 1.2d0 
# 

# The two-way aerosol transmission from the top of the atm to the two calibration 
heights 

# for 532 and the one calibration height for 1064 

# 

GD_AEROSOL_TRANS_HI = 1 . OdO 
GD_AEROSOL_TRANS_IR = 0.98d0 
GD_AEROSOL_TRANS_LO = 0.98d0 
# 

# Factor to multiply molecular difference for bot threshold for 20 s algm 

# 

GD_BMDIFF_FTR = 0.98d0 

# 

# Factor to multiply top threshold for bot threshold for 20 s algm 

# 

GD_BTHR_FTR = 0.96d0 

# 

# Calibration cloud factor for determining cloud threshold 

# 

GD_CAL_CLD_FTR = 1 . 5d0 

# 

# Percent of good records needed (in decimal form) for cal cof sums to be 

# averaged and output to ancillary file 

# 

GD_CAL_PCT = 0 . 5d0 

# 

# Number of standard deviations to eliminate calibration coefficients 

# 
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GD_C C_NUM_S TO = 1 . 3 OdO 

# ” 

# Use previous granule data if last time is within this number secs of 

# current granule time 

# 

GD_CC_PREV_SEC = 3600. OdO 

# 

# Ratio to eliminate calibration coefficients 

# 

GD_C C_RAT I O = 0.5 0 

# 

# The height (m) above which clouds detected by the calibration utility are 

# considered to be cirrus and the 1064 and 532 data are written to anc file 44 

# 

GD_CIRRUS_HT = 10000.0 

# 

# Cloud density threshold 

# 

GD_CLD_DEN S E = 25. OdO 

# 

# Cloud separation height for using low and high consec values (m) 

# 

GD_CLD_SEP_HT = 5 . 0d3 

# 

# Cloud thickness threshold (m) 

# 

GD_CLD_THICK = 230. OdO 

# 

# Cloud threshold factor 

# 

GD_CLD_THR_FTR = 3 . OdO 

# 

# Critical ratio threshold for 20 s algm 

# 

GD_CRAT_THR2 0 = 1 . Odl 

# 

# Critical ratio threshold for 4 s algm 

# 

GD_CRAT_THR4 = 1.25d0 

# 

# Upper limit for valid DEM (meters) 

# 

GD_DEM_HI = 10000. OdO 

# 

# Lower limit for valid DEM (meters) 

# 

GD_DEM_LO = -2000. OdO 

# 

# GLA02%d_DEMmin must be offset by this amount (m) 

# 

GD_DEM_OFFSET = 1000. OdO 

# 

# Cloud/aerosol discrimination thresholds 

# from 21 km to ground by 1 km increments 

# 

#GD_DISCRIM_THR = 6 . Od-13 , 6.0d-13, 6.0d-13, 6.0d-13, 6.0d-13, 6.0d-13, 6.0d-13, 
6 . Od- 13 , 6. Od-13, 6. Od-13, 6. Od-13, 7. Od-13, 8. Od-13, 1.0d-12, 1.5d-12, 4.0d-12, 
6 . Od- 12 , 6 . Od- 12 , 6.0d-12, 6.0d-12, 6.0d-12 

#GD_DISCRIM_THR = 6 . Od-15, 6.0d-15, 6.0d-15, 6.0d-15, 6.0d-15, 6.0d-14, 6.0d-14, 
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6 . Od- 14 , 6 . Od- 14 , 6 . Od- 14 , 6.0d-14, 7.0d-14, 8.0d-12, 1.0d-ll, 

6 . 0d-10 , 6 . 0d-10 , 6 . Od- 10 , 6.0d-10, 6.0d-10 

#GD_DISCRIM_THR = 6 . Od-15, 6.0d-15, 6.0d-15, 6.0d-15, 6.0d-15, 

6 . Od-14 , 6 . Od-14 , 6 . Od- 14 , 6.0d-14, 7.0d-14, 8.0d-12, 1.0d-ll, 

7 . 5d-ll, 1.0d-10, 3 . Od- 10 , 3 . 0d-10 , 3.0d-10 

GD_DISCRIM_THR = 6. Od-15, 6. Od-15, 6. Od-15, 6. Od-15, 6. Od-15, 

6. Od-14, 6. Od-14, 6. Od-14, 6. Od-14, 7. Od-14, 8.0d-12, 1.0d-ll, 

2 . 0d-10 , 3 . 0d-10 , 3 . Od- 10 , 3.0d-10, 3.0d-10 

# 

# Diurnal threshold factor 

# 

#GD_DIURNAL_FTR = 0 . 5d0 

#GD_DIURNAL_FTR = 1.463d-6 

#GD_DIURNAL_FTR = 2.926d-6 

GD_D I URNAL_FTR = 4.380d-6 

# 

# Lower threshold for 532 day/night flag 

# 

GD_DNF_THR1 = 1 . 0d5 

# 

# Upper threshold for 532 day/night flag 

# 

GD_DNF_THR2 = 1 . 0d6 

# 

# 532 background threshold for calibration coefficient elimination (photons/bin) 

# 

GD_G_BKGD_THR = 2 . OdO 

# 

# Ground detection factor 

# 

GD_GDET_FTR = 9 . OdO 

# 

# Lab measured 532 calibration coefficient 

# 

GDJGJGYICALCOF = 9 . 00dl2 

# 

# Half width of calibration band around high calibration height (km) 

# 

GD_H I _HAL FW I D = 4 . OdO 

# 

# Lab measured 1064 calibration coefficient 

# 

GD_IR_LMCALCOF = 4.20dl 

# 

# Half width of calibration band around low calibration height (km) 

# 

GD _ L0 _HAL FW 1 D = 1 . OdO 

# 

# Factor to multiply average molecular bscs for top threshold for 4 s algm 

# 

GD_MAER_FTR = 1 . ldO 

# 

# Factor to multiply average molecular bscs for top threshold for 20 s algm 

# 

GD_MAVG_FTR = 10. OdO 

# 

# Cloud integrated signal threshold 

# 

GD MIN CLD SIG = 5.0d-5 


1 . 5d-10 , 

6 . 0d-14, 
2 . 5d- 11 , 

6 . 0d-14, 
2 . 5d- 11 , 


4 . 0d-10 , 

6 . 0d-14, 
5 . Od- 11 , 

6. 0d-14, 
1.0d-10, 
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# 

# PBL threshold factor 

# 

GD_PBL_THR_FTR = 0.30d0 

# 

# Lower threshold for ratio of GLA07 integrated returns 

# 

GD_RAT_THR1 = 1 . Od- 1 

# 

# Upper threshold for ratio of GLA07 integrated returns 

# 

GD_RAT_THR2 = 1 . Odl 

# 

# Threshold for range from satellite to geoid (m) 

# 

GD_RNG_THR = 5 . 0d5 

# 

# Total to molecular scattering ratio at the two calibration heights for 532 

# and at the one lower height for the 1064 channel 

# 

GD_S C AT_RAT 1 0_H I = 1.0 OdO 
GD_SCAT_RATIO_IR = 1.05d0 
GD_S CAT_RAT 1 0_L0 = 1.03d0 
# 

# Segment heights for cloud detection (tops of bins) 

# 

GD_SEG_HTS = 2 0.5d0, 19. OdO, 17. OdO, 15. OdO, 13. dO, 11. OdO, 10. OdO, 9. OdO, 8. OdO, 
7. OdO, 6. OdO, 5. OdO, 4 . OdO 3. OdO, 2. OdO, 1 . OdO , O.OdO, -2. OdO, -2. OdO, -2. OdO 
# 

# Time tolerance for comparing ANC36 and GLA02 times in A_cal_cofs 

# 

GD_T I ME_TOL = 1 . 0d2 

# 

# Factor to multiply molecular difference for top threshold for 20 s algm 

# 

GD_TMDIFF_FTR = 0.98d0 

# 

# Minimum number of valid 5 Hz profiles in 1 sec buffer 

# 

GI_1SEC_MIN = 2 

# 

# Min number of valid 5 Hz profiles in 20 sec buffer 

# 

GI_2 0 SEC_MIN =50 

# 

# Minimum number of valid 1 sec profiles in 20 sec buffer 

# 

GI_2 0 SEC_MIN1 = 10 

# 

# Min number of valid 5 Hz profiles in 4 sec buffer 

# 

GI_4SEC_MIN = 8 

# 

# Minimum number of valid 1 sec profiles in 4 sec buffer 

# 

GI_4SEC_MIN1 = 2 

# 

# Number of bins to constrain the search for the PBL layer at 4 sec 

# 
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GI_4S_LIM_BIN = 12 

# 

# Number of bins to constrain the search for the PBL layer at 5 Hz 

# 

GI_5HZ_LIM_BIN = 6 

# 

# Height (m) above PBL or surface for aerosol search limit 

# 

GI_AER_BOT_HT = 250 

# 

# Number of bins above optically thick cloud top to end aerosol search at 4 sec 

# 

GI_AER_CLD_OFF = 5 

# 

# Number of bins to constrain the search for aerosol top at 4 sec 

# 

GI_AER_LIM_BIN = 13 

# 

# Number of bins for new molecular threshold in 20 sec aerosol detection 

# 

GI_AER_NPTS = 450 

# 

# Minimum number of bins in an aerosol layer in 20 sec algm 

# 

G I _AE R_NUM_B I N = 3 

# 

# Flag indicating threshold algorithm to use in 20 sec aerosol detection 

# 0=old threshold, l=new molecular threshold 

# 

GI_AER_THR_F = 0 

# 

# Lower limit for std for new molecular threshold in 20 sec aerosol detection 

# 

GI_AER_THR_LL =40 

# 

# Upper limit for std for new molecular threshold in 20 sec aerosol detection 

# 

GI_AER_THR_UL = 160 

# 

# Start Height (m) for 20 sec aerosol search limit 

# 

GI_AER_TOP_HT = 30000 

# 

# Limit for number of bad locations allowed 

# 

GI_BAD_LOC_LIMIT =30 

# 

# Flag to indicate if backscatter quality flags are used to eliminate data 

# Used in the PBL routine A_pbl_lay_mod . f 90 , and possibly elsewhere, but 

# definitely only within level 2 software 

# Not used = 0, used = 1 

# 

GI_BSCS_QF_CHK = 0 

# 

# Flag indicating if 4 sec aerosol layers should be calculated using aerosol 

# routine or if aerosol layers found by cloud algorithm should be used. 

# 0 = use cloud algorithm, 1 = use aerosol algorithm 

# 

#Changed from 1 to 0; 22ja04,WDH 
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GI_CALC_AER_F = 0 

# 

# Start height for cal cof cloud search (m) 

# 

GI_CAL_CLD_HT = 22000 

# 

# Number of seconds that cal cof sums are averaged over (segment length) 

# 

G I _CAL_T I ME = 250 

# 

# Flag to eliminate calibration coefficients (0=no, l=yes) for data that was taken 

# with a background greater than gd_g_bkgd_thr (default vaue of 4.0 photons/bin) 

# 

GI_CC_ELIM_F = 0 

# 

# Flag to tell whether to use the high 532 calibration constant or the low 

# 1 - Use high calibration constant 

# 2 - Use low calibration constant 

# 

GI_CC_INTERP_F = 1 

# 

# This is the order of the least squares polynomial fit that defines a calibration 

# constant fo each second of the granule 

# -1 - linear piecewise fit between each calibration point 

# 0-0 order or segment average 

# 1 - 1st order or linear least square fit: y = a + bx 

# 2 - 2nd order or parobolic fit: y = a + b*x + c*x*x 

# 3 - 3rd order or cubic fit: y = a + b*x + c*x*x + d*x*x*x 

# etc until a max of 10. Note that GI_CC_MFIT = 10 is essentially a linear 

piecewise fit 

# 

GI_CC_MFIT = -1 

# 

# Number of points to use in calibration coefficient Interpolation 

# 

GI_CC_NUM_PTS = 3 

# 

# Number of bins of 532 and 1064 data to write out when the calibration utility 

# detects a cloud. This is for 1064 calibration from cirrus clouds 

# 

GI_CIRRUS_BINS = 6 

# 

# Number of consecutive bins for aerosol layer at 20 sec 

# 

GI_CLD_B IN = 7 

# 

# Number of consecutive bins for aerosol layer at 20 sec 

# 

GI_CONS_AER2 0 = 4 

# 

# Number of consecutive bins for aerosol layer at 4 sec 

# 

GI_CONS_AER4 = 4 

# 

# Number of consecutive bins for ground detection 

# 

GI_CONS_GRD = 2 

# 

# Number of consecutive bins for PBL 
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# 

GI_CONS_PBL = 2 

# 

# Lower threshold for DEM (bins) 

# 

GI_DEM_THR1 = -13 

# 

# Upper threshold for DEM (bins) 

# 

GI_DEM_THR2 = 156 

# 

# Number of bins above surface to start search for ground detection 

# 

GI_DET_T0P_BIN = 7 

# 

# If ground detection is less than DEM by this number of bins, use DEM 

# for lower limit of profile search 

# 

GI_GDET_BIN = 5 

# 

# Don't add profile to cal cof sums if number invalid bins in profile > this 

# threshold 

# 

GI_INVALID_THR = 100 

# 

# Number of consecutive bins for clouds from 10 to 20 km 

# 

GI_NUM_CLD_HI = 3 

# 

# Number of consecutive bins for clouds from 0 to 10 km 

# 

GI_NUM_CLD_LO = 2 

# 

# Number of consecutive bins for clear sky for 10 to 20 km 

# 

GI_NUM_CLR_HI = 3 

# 

# Number of consecutive bins for clear sky for 0 to 10 km 

# 

GI_NUM_CLR_LO = 2 

# 

# Backscatter profile is excluded from PBL search if a cloud top is detected 

# above this height (m) + 20 sec average PBL height and no cloud bottom or 

# ground is detected 

# to turn off the elimination of cloud shots, make this larger than 20000 

# to enable it, make it about 3000 

# 

GI_PBL_CLD_HT = 3000 

# 

# Lower limit for input PBL height 

# 

GI_PBL_LIM1 = 200 

# 

# Upper limit for input PBL height 

# 

GI_PBL_LIM2 = 6000 

# 

# Height (m) above ground detection for PBL search 

# 
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GI_PBL_TOP_HT = 7000 

# 

# Troposphere height (m) above average PBL height 

# 

GI_PBL_TROP_HT = 1000 

# 

# Height (m) above which polar stratospheric clouds are detected 

# 

GI_PSC_HT = 14000 

# 

# Flag indicating if saturated 532 backscatter values should be replaced 

# with 1064 backscatter values: Do not replace = 0, replace = 1 

# 

GI_REPLACE_F = 0 

# 

# Lower height (m) for random noise calculation 

# 

GI_RN_BOT = 22000 

# 

# Upper height (m) for random noise calculation 

# 

GI_RN_T°P = 35000 

# 

# Day number of the year for start of Summer 

# 

GI_SEASON_DEMARC = 111 

# 

# Flag to use calculated or lab-measured constant 532 calib coeff; use 

# constant value = 0; use calculated value = 1 

# 

GI_USE_GCC_F = 1 

# 

# Flag to use calculated or lab-measured constant 1064 calib coeff; use 

# constant value = 0; use calculated value = 1 

# 

GI_USE_IRCC_F = 0 

# 

# Quality Assurance dumping intervals [seconds] 

# 

I_QA0 7_DUMP_TME = 16 
I_QA0 8_DUMP_TME = 16 
I_QA0 9_DUMP_TME = 16 
I_QA1 0_DUMP_TME =16 
I_QA11_DUMP_TME =16 
# 

# Preliminary smoothing-filter half-width for cloud height derivation 

# done from 1064nm data 

# 

GI_IR_CLDSMTH_HWD_PRELM = 1 

# 

# Preliminary smoothing-filter type for cloud height derivation 

# done from 1064nm data 

# 

GI_IR_CLDSMTH_TYPE_PRELM = 2 

# 

# Primary smoothing-filter half-width for cloud height derivation 

# done from 1064nm data 

# 

GI IR CLDSMTH HWD PRIME = 3 
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# 

# Primary smoothing-filter type for cloud height derivation 

# done from 1064nm data 

# 

GI_IR_CLDSMTH_TYPE_PRIME = 1 

# 

# Value defining maximum allowed energy level for IR cloud search 

# 

GD_IR_MAX_ENERGY = 10.0D0 

# 

# Adjustment for tuning of lowest bin defining base of atmospheric 

# column in search for cloud tops 

# 

GI_IR_CLD_LOWBIN_ADJ = 2 

# 

# Number of consecutive bins above threshold required to 

# indicate a cloud top 

# 

GI_IR_CLD_CONSEC = 4 

# 

# Energy threshold defining whether a cloud layer exists or not 

# 

GD_IR_CLOUD_THRESH = 1.10D-5 

# 

# Energy threshold defining whether integrated signal is real 

# 

GD_INTEG_THRESHOLD = 1.0D-7 

# 

# Energy threshold of integrated signal which implies a cloud 

# 

GD_I S I G_CLOUD_THR = 0.50D-5 

# 

# Number of Levels Above Energy threshold of in search to identify low cloud 

# 

GI_LOW_CLOUD_COUNT = 3 

# 

END_OF_ATM = 

# 

END_OF_ANC07_FILE = 

# 

B.3.5 Elevation Constants 

# 

# Elevation Constants Mod Entries 

# 

# 2007-02-08 LARoberts, removed GD_SGMR2 , SURFRUF_PULSEWID , GD_MAX_SLOPE , 

# & REC_IMPULSE (2459) 

# 2008-02-26 LARoberts, moved GI_MIN_SATNDX to const_glob_mod 

# 2008-02-29 LARoberts, added GI_MIN4SAT, GD_FULLWDTH & GD_PCTSATTH (2356) 

BEG_OF_ELEV = 

ELEV_VERS = ANC07 Elev Globals V6 . 0 2008-02-29 

# 

# gravity effect in milligals 

# 

gravEffTide = 9.8d0 

# 

# Constants used in calc of earth tide 
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# 

earthTdH2 = 0.609d0 

# 

# Constants used in calc of earth tide 

# 

earthTdH3 = 0.291d0 

# 

# Beam Divergence Angle 

# 

#DIVANGLE = O.OOOlldO 

# 

# QAP Track length (in secs) 

# 

QAPTRKLEN = 16 . OdO 

# 

# Estimated Roundtrip Atmosphere Transmission 

# 

GD_T_RTATM = 0 . 98d0 

# 

# Filtering Ground Track Azimuth Parameters 
GT_AZIMUTH_STDEV = 200. ODO 

GT_AZ I MUTH_NUM_VAL S = 4 

# min GLA05%i_satNdx to be counted as saturated 
GI_MIN4SAT = 2 

# 

# percent saturation threshold for computing the saturation correction 
GD_PCTSATTH = 2 . OdO 

# full width threshold for setting i_satCorrFlg 
GD_FULLWDTH = 100. OdO 

# 

END_0 F_E LEV = 

# 

END OF ANC07 FILE = 
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Appendix C 

GSAS ANC06 File Content 

C.1 ANC06 Overview 

GSAS software creates ANC06 output files as required by GSDP-3 1100 (refer to the GLAS 
Science Software Requirements Document). The ANC06 file contains processing informa- 
tion, error messages, and status messages. The file is in standard GSAS keyword=value for- 
mat. The format of an ANC06 entry is: 

[keyword] = [value] 

The first field [keyword] is a keyword describing the type of infonnation presented. The sec- 
ond field [value] is standardized for use in ANC06. It contains two subfields: the time and a 
text message. The time is that of the data being processed when the entry was written (if no 
data have been processed, the time may be 0 or an invalid value). The time is a GSAS-stan- 
dard time representation (currently UTC seconds). 

[time] [message] 

Each type of message may have different message field fonnats. The rules for parsing an 
ANC06 entry are: 

• the keyword is the string left of the “=” 

• the data time is the number immediately to the right of the “=” 

• the messages text is the infonnation after the data time 

C.2 ANC06 Example and Description 

A sample ANC06 file, created during V 1 Acceptance Testing, is examined below. In this 
example, multiple spaces have been compressed to a single space for readability. 

The first entries in the example ANC06 file show what files were initially opened. The mes- 
sage part of each entry is a GSAS standard error/status message. The first field of the enor / 
status message is the error code, the second is the enor severity, the third is the reporting rou- 
tine and the last is the enor text. 

All initial input files are opened, (this section has been edited for brevity) 


0 STATUS= 10005, 0, OpenFInFile, 
gla05_0 02_ll_0 0 0 1_0 0 2 8_2_0 0_0 0 . dat 

Opened 

file : 

( Input ) 

0 STATUS= 10005, 0, OpenFInFile, 
anc01_001_20000101_060000_01_00.dat 

Opened 

file : 

( Input ) 

0 STATUS= 10005, 0, OpenFInFile, 
anc01_001_20000101_060000_01_02.dat 

Opened 

file : 

(Input) 

0 STATUS= 10005, 0, OpenFInFile, 
anc01_001_20000101_060000_01_03.dat 

Opened 

file : 

(Input) 

0 STATUS= 10005, 0, OpenFInFile, 
anc01_001_20000101_060000_01_04.dat 

Opened 

file : 

(Input) 

0 STATUS= 10005, 0, OpenFInFile, 

Opened 

file : 

(Input) 
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ancOl 001 20000101 060000 01 01.dat 


0 

STATUS = 

10005, 

0, 

OpenFInFile , 

Opened 

file : 

(Input) 

anc07 

_001_ 

_ 01 _ 

00 . dat 

0 

STATUS = 

10005, 

0, 

OpenFInFile , 

Opened 

f ile : 

(Input) 

anc07 

_001_ 

_CH_ 

01 . dat 

0 

STATUS = 

10005, 

0, 

OpenFInFile , 

Opened 

file : 

(Input) 

anc07 

_001_ 

_ 01 _ 

03 . dat 


0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc08_001_20000101_000000_01_00.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc09 001 20000101 000000 01 00.dat 


0 

STATUS = 

10005, 

0 , 

OpenFInFile , 

Opened 

file 

(Input) 

and 2 

_0 0 0 _ 

_0 0_ 

00 . dat 

0 

STATUS = 

10005, 

0 , 

OpenFInFile , 

Opened 

file 

(Input) 

and 2 

_ 000 _ 

_0 0 _ 

01 . dat 

0 

STATUS = 

10005, 

0 , 

OpenFInFile , 

Opened 

file 

(Input) 

and 3 

_ 001 _ 

_ 01 _ 

00 . dat 

0 

STATUS = 

10005, 

0 , 

OpenFInFile , 

Opened 

file 

(Input) 

and 6 

_ 001 _ 

_ 01 _ 

00 . dat 

0 

STATUS = 

10005, 

0 , 

OpenFInFile , 

Opened 

file 

(Input) 

and 7 

_0 0 !_ 

_ 01 _ 

00 . dat 


0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc24_001_20000101_000000_01_00.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) anc27_001_01_00.dat 
0 STATUS = 10005, 0, OpenFInFile, Opened file: (Input) anc27_001_01_01.dat 


0 STATUS= 10005, 0, OpenFOutFile , 
gla06_0 02_ll_0 0 0 1_0 0 2 8_2_0 0_0 0 . dat 

Opened 

file : 

(Output 

0 STATUS= 10005, 0, OpenFOutFile, 
glal2_0 02_ll_0 0 0 1_0 0 1 5_0_0 0_0 0 . dat 

Opened 

file : 

(Output 

0 STATUS= 10005, 0, OpenFOutFile, 
glal3_002_ll_0001_0015_0_00_00.dat 

Opened 

file : 

(Output 

0 STATUS= 10005, 0, OpenFOutFile, 
glal4_0 02_ll_0 0 0 1_0 0 1 5_0_0 0_0 0 . dat 

Opened 

file : 

(Output 

0 STATUS= 10005, 0, OpenFOutFile, 
glal5_0 02_ll_0 0 0 1_0 0 1 5_0_0 0_0 0 . dat 

Opened 

file : 

(Output 

0 STATUS= 10005, 0, OpenFOutFile, 
qap06_002_ll_0001_0028_2_00_00.dat 

Opened 

file : 

(Output 

0 STATUS= 10005, 0, OpenFOutFile, 
qapl2_0 02_ll_0 0 0 1_0 0 1 5_0_0 0_0 0 . dat 

Opened 

file : 

(Output 

0 STATUS= 10005, 0, OpenFOutFile, 
qapl3_0 02_ll_00 0 1_0 0 15_0_0 0_0 0 . dat 

Opened 

file : 

(Output 

0 STATUS= 10005, 0, OpenFOutFile, 
qapl4_0 02_ll_00 0 1_0 0 15_0_0 0_0 0 . dat 

Opened 

file : 

(Output 

0 STATUS= 10005, 0, OpenFOutFile, 

Opened 

file : 

(Output 


qapl5_0 02_ll_0 0 0 1_0 0 1 5_0_0 0_0 0 . dat 

0 STATUS= 10010, 0, exec_lib, OpenFiles Subroutine status End of execution 

The control file name is referenced. 

o #= 

0 #=Control File Name 

0 #= 

0 CF_NAME=cf_p3tl . ctl 

The control file contents are listed. Notice that “=” is replaced with so there is no chance 
of the keyword/value processor being confused. Comments are retained, (this section has been 
edited for brevity) 

0 CONTROL=# 

0 CONTROL=# Execution Information 

0 CONTROL=# 

0 CONTROL= EXEC_KEY : p3tl 

0 CONTROL= DATE_GENERATED : 2 1 September 2001 
0 CONTROL= OPERATOR: j lee 
0 CONTROL=# 

0 CONTROL=# Static ANC Files 

0 CONTROL=# 
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o 

o 

0 

0 

0 


C0NTR0L=# Input ANC07 Files : 00=error, 01=global, 03=atmosphere 
CONTROL=# 

CONTROL= INPUT_FILE : anc07_001_01_00 . dat 0000000 1000000 
CONTROL= INPUT_FILE: anc07_001_01_01.dat 0000000 1000000 
CONTROL= INPUT FILE:anc07 001 01 03.dat 0000000 1000000 


0 

90000 . 0000 
0 

90000 . 0000 
0 
0 
0 
0 
0 
0 
0 
0 
0 


CONTROL= OUTPUT_FILE : qapl4_002_ll_0001_0043_0_00_00 . dat 84922.3646 
CONTROL= OUTPUT_FILE : qapl5_002_ll_0001_0043_0_00_00 . dat 84922.3646 
CONTROL=# 

CONTROL=# Execution Control 

CONTROL=# 

CONTROL= WAVEFORM_PROCESS:NONE 
CONTROL= ELEVATION_PROCESS :ALL 
CONTROL= SURFACE_TYPE : ALL 
CONTROL=# 

CONTROL=# End of Control File 

CONTROL=# 


The exec version number is referenced. 


o #= 

0 #=Exec Version Information 

0 # = 

0 EXE_VERSION=GLAS_Alt v2 . 0 , October 2001 

The associated library version numbers are referenced. 

o # = 

0 #=Common Library Version Information 

0 #= 

0 LIB_VERSION=libexec V2 , October 2001 
0 LIB_VERSION=libplatf orm V2 . 0 , October 2001 
0 LIB_VERSION=libcntrl V2 . 0 , October 2001 
0 LIB_VERSION=libprod V2 . 0 , October 2001 
0 LIB_VERSION=libf ile V2 . 0 , October 2001 
0 LIB_VERSION=libtime V2 . 0 , October 2001 
0 LIB_VERSION=liberr V2 . 0 , October 2001 
0 LIB_VERSION=libanc V2 . 0 , October 2001 
0 LIB_VERSION=libmath V2 . 0 , October 2001 
0 LIB_VERSION=libgeo V2 . 0 , October 2001 

The associated subsystem version number is referenced. 

o # = 

0 #=Subsystem Version Information 

0 #= 

0 WF_VERSION=libwf v2 . 0 , October 2001 
0 ELEV_VERSION=libelev v2 . 0 , October 2001 

Ancillary files which remain resident in core are read are then closed. 

0 STATUS= 10011, 0, ReadAnc, ReadAnc Subroutine status Start of execution 
0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_060000_01_00.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

ancOl 001 20000101 060000 01 02.dat 
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0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_060000_01_04.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_060000_01_03.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_060000_01_01.dat 

0 STATUS= 10007, 0, ReadANC, Finished reading file: 
anc01_001_20000101_06 0000_01_00.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_12 0000_01_00.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_120000_01_02.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_120000_01_04.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_12 0000_01_03.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_120000_01_01.dat 

0 STATUS= 10007, 0, ReadANC, Finished reading file: 
anc01_001_20000101_12 0000_01_00.dat 

0 STATUS= 10007, 0, ReadANC, Finished reading file: anc07_001_01_00.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: anc07_001_01_00.dat 

0 STATUS= 10007, 0, ReadANC, Finished reading file: anc07_001_01_01.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: anc07_001_01_01.dat 

0 STATUS= 10007, 0, ReadANC, Finished reading file: anc07_001_01_03.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: anc07_001_01_03.dat 

0 STATUS= 10015, 0, ReadANC, Initialized file information 
anc08_001_20000101_000000_01_00.dat 

0 STATUS= 10015, 0, ReadANC, Initialized file information 
ancl2_000_00_00 . dat 

0 STATUS= 10007, 0, ReadANC, Finished reading file: ancl2_000_00_01.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: ancl2_000_00_01.dat 

0 STATUS= 50005, 0, C_LoadGeoid, IN E_GETGEO I D subroutine status 
0 STATUS= 10007, 0, ReadANC, Finished reading file: ancl3_001_01_00.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: ancl3_001_01_00.dat 

0 STATUS= 10015, 0, ReadANC, Initialized file information 
ancl6_001_01_00 . dat 

0 STATUS= 10015, 0, ReadANC, Initialized file information 
ancl7_001_01_00 . dat 

0 STATUS= 10015, 0, ReadANC, Initialized file information 
anc24_001_20000101_000000_01_00.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: anc27_001_01_01.dat 
0 STATUS= 10011, 0, ReadAnc, ReadAnc Subroutine status End of execution 

Parsed execution flag values are referenced. 

o # = 

0 #=Execution Control Flags 

0 # = 

0 SURFACE_TYPE=Land = T 
0 SURFACE_TYPE=Ocean = T 
0 SURFACE_TYPE=Sea_Ice = T 
0 SURFACE_TYPE=Ice_Sheet = T 
0 MANAGER_EXEC=Wavef orm = F 
0 MANAGER_EXEC=Elevation = T 
0 ELEVATION_PROCESS=E_CalcLoadTD = T 
0 ELEVATION_PROCESS=E_CalcOceanTD = T 
0 ELEVATION_PROCESS=E_CalcEarthTD = T 
0 ELEVATION PROCESS=E CalcPoleTD = T 
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0 ELEVATION_PROCESS=E_GetGeoid = T 
0 ELEVATION_PROCESS=E_CalcTrop = T 
0 ELEVATION_PROCESS=E_IntrpPOD = T 
0 ELEVATION_PROCESS=E_CalcStdIR = T 
0 ELEVATION_PROCESS=E_CalcLdIR = T 
0 ELEVATION_PROCESS=E_CalcOcIR = T 
0 ELEVATION_PROCESS=E_CalcSiIR = T 
0 ELEVATION_PROCESS=E_CalcIsIR = T 
0 ELEVATION_PROCESS=E_CalcSpLoc = T 
0 ELEVATION_PROCESS=E_AtmQF = T 
0 ELEVAT I ON_PROCESS =E_Ca 1 c S 1 ope = T 
0 ELEVAT I ON_PROCESS=E_CalcRefl = T 
0 ELEVAT I ON_PROCESS=E_ChckReg = T 
0 ELEVAT I ON_PROCESS=E_CalcRegRng = T 
0 ELEVAT I ON_PROCESS=E_CalcRegParm = T 
0 ELEVAT I ON_PROCESS=E_CalcDEM = T 

Version information from applicable ancillary files is referenced. 

o # = 

0 #=Ancillary File Version Information 

0 # = 

0 ANC_VERSION=ANC07 Error V2 . 0 October 2001 
0 ANC_VERSION=ANC07 Status V2 . 0 October 2001 
0 ANC_VERSION=ANC07 Globals v2 . 0 October 2001 
0 ANC_VERSION=no ANC07 Atm globals read 
0 ANC_VERSION=ANC07 Elev Globals vl . 0 Fri Mar 10 11:2 
0 ANC_VERSION=no ANC07 WF globals read 
0 ANC_VERSION=no ANC07 L1A globals read 
0 ANC_VERSION= 

0 ANC_VERSION= Vers ion 1.0, 04/12/2000* 

0 ANC_VERSION=ancl3_dem not read 
0 ANC_VERSION=ancl6_ltide not read 
0 ANC_VERSION=ancl7_otide not read 

Execution trace proceeds. Granules are opened/closed dynamically, (this section has been 
edited for brevity) 

o #= 

0 #=Execution Status 

0 # = 

0 STATUS= 10012, 0, ReadData, ReadData Subroutine status 
0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_12 0000_01_00.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_120000_01_02.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_120000_01_04.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc 0 1_0 0 1_2 0 0 0 010 1_1 2 0 0 0 0_0 1__0 3 . dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_12 0000_01_01.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: 
anc01_001_20000101_060000_01_00.dat 

0 STATUS = 10006, 0, CloseFile, Closed file: 
anc01_001_20000101_060000_01_02.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: 
anc01_001_20000101_060000_01_04.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: 
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anc01_001_20000101_06 0000_01_03.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: 
anc01_001_20000101_060000_01_01.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_18 0000_01_00.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_18 0000_01_02.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_18 0000_01_04.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_18 0000_01_03.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

anc01_001_20000101_180000_01_01.dat 

0 STATUS= 50006, 0, C_IntrpPOD, IN C^IntrpPOD subroutine status 
0 STATUS= 50008, 0, C_CalcSpLoc, IN C_CALCSPLOC subroutine status 
0 STATUS= 50002, 0, E_CalcOceanTD , IN E_CalcOceanTd subroutine status 
0 STATUS= 50003, 0, E_CalcEarthTD , IN E_CalcEarthTd subroutine status 
0 STATUS= 50001, 0, E_CalcLoadTD , In E_CalcLoadTd subroutine status 
0 STATUS= 50013, 0, E_CalcTrop, IN E_CalcTrop subroutine status 
0 STATUS= 50017, 0, E_CalcDEM, IN E_CalcDEM subroutine status 
0 STATUS= 50010, 0, E_CalcSlope, IN E_CALCSLOPE subroutine status 
0 ERROR=-50022 , 2, e_calcslope, Cannot take sq. root of negative quantity 
cant take square root of a negative quantity 

0 STATUS= 50021, 0, E_OceanParm, IN E_OceanParm subroutine status 


0 STATUS= 10007, 0, NextGranule, Finished reading file: 
gla05_002_ll_0001_0028_2_00_00.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: 
gla05_002_ll_0001_0028_2_00_00.dat 

0 STATUS= 10005, 0, OpenFInFile, Opened file: (Input) 

gla05_002_ll_0001_0028_3_00_00.dat 

8100 STATUS= 10006, 0, CloseFile, Closed file: 
gla06_0 02_ll_0 0 0 1_0 0 2 8_2_0 0_0 0 . dat 

8100 STATUS= 10005, 0, OpenFOutFile , Opened file: (Output) 

gla06_002_ll_0001_0028_3_00_00.dat 

8100 STATUS= 10005, 0, OpenFiles, Opened file: (In- 

put) gla06_002_ll_0001_0028_3_00_00 .dat 

8100 STATUS= 10006, 0, CloseFile, Closed file: 
qap06_0 02_ll_0 0 0 1_0 0 2 8_2_0 0_0 0 . dat 

8100 STATUS= 10005, 0, OpenFOutFile, Opened file: (Output) 

qap06_0 02_ll_0 0 0 1_0 0 2 8_3_0 0_0 0 . dat 

8100 STATUS= 10005, 0, OpenFiles, Opened file: (In- 

put ) qap06_00 2_11_0 00 1_0 02 8_3_00_00 . dat 


899590 STATUS= 50013, 0, E_CalcTrop, IN E_CalcTrop subroutine status 
899790 STATUS= 50017, 0, E_CalcDEM, IN E_CalcDEM subroutine status 
899800 STATUS= 50010, 0, E_CalcSlope, IN E_CALCSLOPE subroutine status 
0 STATUS= 10007, 0, NextGranule, Finished reading file: 
gla05_002_ll_0001_0043_4_00_00.dat 

0 STATUS= 10006, 0, CloseFile, Closed file: 
gla05_002_ll_0001_0043_4_00_00.dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
gla06_002_ll_0001_0043_4_00_00.dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
qap06_0 02_ll_00 0 1_0 04 3_4_0 0_0 0 . dat 
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899990 STATUS= 10006, 0, CloseFile, Closed file: 
glal2_002_ll_0001_0043_0_00_00.dat 

899990 STATUS = 10006, 0, CloseFile, Closed file: 
glal3_002_ll_0001_0043_0_00_00.dat 

899990 STATUS = 10006, 0, CloseFile, Closed file: 
glal4_002_ll_0001_0043_0_00_00.dat 

899990 STATUS = 10006, 0, CloseFile, Closed file: 
glal5_002_ll_0001_0043_0_00_00.dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
qapl2_0 02_ll_0 0 0 1_0 043_0_0 0_00 . dat 

899990 STATUS = 10006, 0, CloseFile, Closed file: 
qapl3_0 02_ll_0 0 0 1_0 04 3_0_0 0_00 . dat 

899990 STATUS = 10006, 0, CloseFile, Closed file: 
qapl4_0 02_ll_0 0 0 1_0 04 3_0_0 0_00 . dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
qapl5_0 02_ll_0 0 0 1_0 04 3_0_0 0_00 . dat 

899990 STATUS= 10013, 0, exec_lib, MainWrap Subroutine status Start of execu- 
tion 

An summary of input files/records is created, (this section has been edited for brevity) 

899990 STATUS= 10013, 0, exec_lib, MainWrap Subroutine status Start of execu- 
tion 

899990 #= 

899990 #=Input/Output Wrapup Summary 

899990 #= 

899990 INPUT_SUMMARY=gla05_002_ll_0001_0028_2_00_00 . dat : read 810 records 
899990 INPUT_SUMMARY=gla05_002_ll_0001_0028_3_00_00 . dat : read 1287 records 
899990 INPUT_SUMMARY=gla05_002_ll_0001_0028_4_00_00-dat: read 1616 records 
899990 INPUT_SUMMARY=gla05_002_ll_0001_0029_l_00_00 . dat : read 1281 records 
899990 INPUT_SUMMARY=gla05_002_ll_0001_0029_2_00_00 . dat : read 1616 records 
899990 INPUT_SUMMARY=gla05_002_ll_0001_0029_3_00_00 . dat : read 1287 records 
899990 INPUT_SUMMARY=gla05_002_ll_0001_0029_4_00_00 . dat : read 1617 records 
899990 INPUT_SUMMARY=gla05_002_ll_0001_0030_l_00_00 . dat : read 1281 records 
899990 INPUT_SUMMARY=gla05_002_ll_0001_0030_2_00_00 . dat : read 1616 records 
899990 INPUT_SUMMARY=gla05_002_ll_0001_0030_3_00_00 . dat : read 1287 records 
899990 INPUT_SUMMARY=gla05_002_ll_0001_0030_4_00_00 . dat : read 1617 records 
899990 INPUT_SUMMARY=gla05_002_ll_0001_0031_l_00_00 . dat : read 1280 records 


899990 INPUT_SUMMARY=ancl7_001_01_00,dat: read 0 records 

899990 INPUT_SUMMARY=anc24_001_20000101_000000_01_00 .dat: read 0 records 
899990 INPUT_SUMMARY=anc27_001_01_00 . dat : read 0 records 
899990 INPUT_SUMMARY=anc27_001_01_01.dat: read 0 records 

An summary of output files/records is created, (this section has been edited for brevity) 

899990 OUTPUT_SUMMARY=gla06_002_ll_0001_0028_2_00_00 .dat: wrote 811 records 
899990 OUTPUT_SUMMARY=gla06_002_ll_0001_0028_3_00_00 .dat: wrote 1288 records 

899990 OUTPUT_SUMMARY=gla06_002_ll_0001_0028_4_00_00 .dat: wrote 1617 records 

899990 OUTPUT_SUMMARY=gla06_002_ll_0001_0029_l_00_00 .dat: wrote 1282 records 

899990 OUTPUT_SUMMARY=gla06_002_ll_0001_0029_2_00_00 .dat: wrote 1617 records 

899990 OUTPUT_SUMMARY=gla06_002_ll_0001_0029_3_00_00 .dat: wrote 1288 records 

899990 OUTPUT_SUMMARY=gla06_002_ll_0001_0029_4_00_00 .dat: wrote 1618 records 

899990 OUTPUT_SUMMARY=gla06_002_ll_0001_0030_l_00_00 .dat: wrote 1282 records 

899990 OUTPUT_SUMMARY=gla06_002_ll_0001_0030_2_00_00 .dat: wrote 1617 records 

899990 OUTPUT_SUMMARY=gla06_002_ll_0001_0030_3_00_00 .dat: wrote 1288 records 
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899990 OUTPUT_SUMMARY=qapl4_002_ll_0001_0029_0_00_00 . dat : wrote 0 records 
899990 OUTPUT_SUMMARY=qapl4_002_ll_0001_0043_0_00_00 .dat: wrote 0 records 
899990 OUTPUT_SUMMARY=qapl5_002_ll_0001_0015_0_00_00 .dat: wrote 0 records 
899990 OUTPUT_SUMMARY=qapl5_0 02_1 1_0 0 01_0 02 9_0_0 0_0 0 . dat : wrote 0 records 
899990 OUTPUT_SUMMARY=qapl5_002_ll_0001_0043_0_00_00 .dat: wrote 0 records 

An summary of error/status messages is created, (this section has been edited for brevity) 

899990 #= 

899990 #=Status/Error Wrapup Summary 

899990 #= 

899990 ERROR_SUMMARY= 2833426 Cannot take sq. root of negative quantity 
899990 S TATU S_SUMMARY = 356 Opened file: 

899990 S TATU S_SUMMARY = 244 Closed file: 

899990 S TATU S_SUMMARY = 68 Finished reading file: 

8 9 99 90 S TATU S_SUMMARY = 1 ReadAnc Subroutine status 
899990 S TATU S_SUMMARY = 89693 ReadData Subroutine status 
899990 STATUS_SUMMARY= 1 MainWrap Subroutine status 
899990 S TATU S_SUMMARY = 5 Initialized file information 
899990 S TATU S_SUMMARY = 358731 In E_CalcLoadTd subroutine status 
899990 S TATU S_SUMMARY = 179370 IN E_CalcOceanTd subroutine status 
899990 S TATU S_SUMMARY = 179370 IN E_CalcEarthTd subroutine status 
899990 S TATU S_SUMMARY = 179371 IN E_GETGEOID subroutine status 
899990 S TATU S_SUMMARY = 3587400 IN C_IntrpPOD subroutine status 
899990 S TATU S_SUMMARY = 13915989 IN C_CALCSPLOC subroutine status 
8 9 99 90 S TATU S_SUMMARY = 2838356 IN E_CALCSLOPE subroutine status 
899990 S TATU S_SUMMARY = 3587215 IN E_CalcTrop subroutine status 
899990 S TATU S_SUMMARY = 8425624 IN E_CalcDEM subroutine status 
899990 S TATU S_SUMMARY = 1024984 IN E_LandParm subroutine status 
899990 S TATU S_SUMMARY = 2557848 IN E_OceanParm subroutine status 

Any remaining open files are closed. 

899990 STATUS= 10013, 0, exec_lib, MainWrap Subroutine status End of execution 
899990 STATUS = 10014, 0, exec_lib, CloseFiles Subroutine status Start of ex- 
ecution 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
anc01_001_20000102_120000_01_00.dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
anc01_001_20000102_18 0000_01_00.dat 

899990 STATUS = 10006, 0, CloseFile, Closed file: 
anc01_001_20000102_120000_01_02.dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
anc01_001_20000102_180000_01_02.dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
anc 0 1_0 0 1_2 0 0 0 01 0 2_1 2 0 0 0 0_0 1_0 3 .dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
anc 0 1_0 0 1_2 0 0 0 01 0 2_1 8 0 0 0 0_0 1_0 3 .dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
anc01_001_20000102_120000_01_04.dat 

899990 STATUS = 10006, 0, CloseFile, Closed file: 
anc01_001_20000102_180000_01_04.dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
anc01_001_20000102_120000_01_01.dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: 
anc01_001_20000102_180000_01_01.dat 

899990 STATUS = 10006, 0, CloseFile, Closed file: 
anc08 001 20000101 000000 01 00. dat 
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899990 STATUS= 10006, 0, CloseFile, Closed file: 
anc09 001 20000101 000000 01 00.dat 


899990 

STATUS = 

10006, 

0 , 

CloseFile, 

Closed 

file : 

and 2 

0 0 0_ 

_0 0_ 

00 . dat 

899990 

STATUS = 

10006, 

0 , 

CloseFile , 

Closed 

file : 

and 6 

0 0 1_ 

_01_ 

00 . dat 

899990 

STATUS = 

10006, 

0 , 

CloseFile, 

Closed 

file : 

and 7 

001 _ 

_01_ 

00 . dat 

899990 

STATUS = 

10006, 

0 , 

CloseFile , 

Closed 

file : 






anc24_0 0 1_2 0 0 0 010 1_0 0 0 0 0 0_0 1_0 0 . dat 

899990 STATUS= 10006, 0, CloseFile, Closed file: anc27_001_01_00.dat 
899990 STATUS= 10014, 0, exec_lib, CloseFiles Subroutine status End of execu- 
tion 
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This section list errors and possible solutions for each error defined in GSAS. 

D.1 General Errors 

-10001 Error Opening File for Input: 

The operating system was unable to open the specified input file. Verify that the requested file 
exists in (or is correctly linked into) the current directory. Verify the spelling of the filename 
within the control file (filenames are case-sensitive). Verily that the user has read pennission 
on the file. 

-10002 No control file specified. 

A control file must be specified as a command-line argument when GLASExec is executed. 
If a control file was specified, then perfonn the following verification steps: Verily that the 
control file exists in (or is correctly linked into) the current directory. Verify that the user has 
read permission on the control file 

-10003 Bad recndx in control file. 

A bad start or stop time was specified in the control file. The start/stop times are fractional 
numbers representing UTC seconds. The times must contain only digits and the decimal point. 

-10004 Stop rec ndx > start rec ndx. 

A start time which was chronologically greater than the stop time was found in the control 
file. Start times must be less than stop times. 

-10005 Previous granule stop > current start. 

Multiple granules of the same type were specified in the control file. The start time of a previ- 
ous granule was chronologically greater than the stop time of the current granules. Multiple 
granules of the same type must not have time spans which overlap within the same control 
file. The granules must be entered in the control file in chronological order. 

-10006 Error Opening File for Output: 

The operating system was unable to open the specified output file. Verify that the requested 
file does not already exists in (or is correctly linked into) the current directory. Verify that the 
user has write pennission on the current directory. 

-10007 Error Closing File: 

The operating system returned an enor code when attempting to close a file. Verify that 
opened files were not moved from the current directory while GLAS Exec was running. This 
is an unusual error and would nonnally indicate a programming error. 

-10008 Error Reading File: 

The operating system returned an error code when attempting to read a file. Verify that files 
listed in the control file are present and accessible in the current directory. This is an unusual 
error and would normally indicate a programming error or a corrupt input file. 
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-10009 Error Writing File: 

The operating system returned an error code when attempting to write a file. Verify that files 
listed in the control file are present and accessible in the current directory. This is an unusual 
error and would normally indicate a programming error or a full file system. 

-10010 Error Reading ANC07: 

The operating system returned an error code when attempting to read the specified ANC07 
file. Verify that the ANC07 files listed in the control file are present and accessible in the cur- 
rent directory. If all files are present, this indicates corruption in the ANC07 file. Appendix B 
describes the format of ANC07 files, verify the ANC07 file contents. 

-10011 Unknown Keyword in ANC07: 

The ANC07 file reader has found a keyword it does not recognize in the ANC07 file. This 
usually indicates corruption in the ANC07 file. Appendix B lists recognized ANC07 key- 
words. Verify the ANC07 file contents. 

-10012 Multiple single-instance keywords: 

The control file parser has detected multiple instances of single-instance keywords in the con- 
trol file. Appendix C details single and multiple-instance keywords in the control file. Verify 
the control file contents. 

-10013 Multiple-instance keyword limit exceeded: 

The control file parser has detected that the number of instances of a multiple-instance key- 
word has been exceeded. Verify the control file contents. 

-10014 Unrecognized line in control file: 

The control file parser has found a line in the control file which it does not recognize. Appen- 
dix C details the format of the control file. Verify the control file contents. 

-10015 Unknown value in keyword/value pair: 

The control file parser has found a line in the control file with a value it does not recognize. 
Certain keywords are required to have only certain values. Appendix C lists possible values 
within the control file. Verify the control file contents. 

-10016 I/O Error Opening Control File: 

The operating system was unable to open the specified control file. Verify that the requested 
file exists in (or is correctly linked into) the current directory. Verify the spelling of the file- 
name on the command line. Verify that the user has read pennission on the file. 

-10017 Error Reading Control File: 

The operating system returned an error code when attempting to read the control file. Verify 
that the control file is present and accessible in the current directory. This is an unusual error 
and would normally indicate a programming error or a corrupt control file. 

-10018 Specified Unknown File Type: 

An unknown file type was specified in the control file. A file type is represented by the first 5 
characters of the filename. Appendix A lists recognized GLAS file types. Verify the control 
file. 
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-10019 GLA01 Unknown Record Type 

An unknown record type was found within the GLA01 file. Valid record types are header, 
body, long and short. This error indicates a corrupt GLA01 file or a program error. 

-10020 GLA01 Exceeded Waveform Record Limit 

The number of wavefonn records per second was exceeded in the GLA01 file. This error indi- 
cates a corrupt GLA0 1 file or a program error. 

-10021 GLA00 Unknown APid 

An unknown APID was detected in the GLA00 data. This error indicates corrupt GLA00 data. 

-10022 GLA00 Wrong APid 

.This error indicates that the expected APID number was not found in the file being read. This 
error indicates corrupt GLA00 data. 

-10023 Max APIDs per sec exceeded 

This indicates that the maximum number of APIDs per second has been exceeded. This error 
indicates corrupt GLA00 data. 

-10024 Data Time < Granule Start Time 

This indicates that data was lost because the time of the current record is less than the start 
time of the current granule. Verify the start and stop times in the control file. 

-10025 Error Reading Standard Atmosphere file header 

An error was detected reading the Standard Atmosphere file header. This indicates a corrupt 
Standard Atmosphere file. 

-10026 Error Reading Standard Atmosphere file data 

An error was detected reading the Standard Atmosphere file data. This indicates a corrupt 
Standard Atmosphere file. 

-10027 Error Reading Global Aerosol map 

An error was detected reading the Global Aerosol file data. This indicates a corrupt Global 
Aerosol file. 

-10028 Error Reading Aerosol Troposphere map 

An error was detected reading the Aerosol troposphere file data. This indicates a corrupt 
Aerosol Troposphere map file. 

-10029 Duplicate APID found 

An error was detected when duplicate APID records were found while processing GLA00 
APID data. A duplicate APID is defined as one having the same APID number and same mis- 
sion elapsed time. 

-10030 EOF or Error Reading ANC33 

An error was detected while reading the ANC33 file. Verify that the file exists and has the cor- 
rect fonnat. 

-10031 Exceeded maximum GLA00 index entries 

The number of GLA00 index entries in the ANC29 file exceeded the maximum allowed. Con- 
tact the GSAS Development team. 
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-10032 Non-zero version in APID Primary Hdr 

An inconsistency was detected in an APID primary header field. This is most likely due to a 
corrupt APID file. 

-10033 Mismatched APID numbers in phdr and file 

An error was detected when verifying that the APID number within the APID data did not 
match the expected APID number designated by the file type. This is most likely due to a cor- 
rupt APID file. 

-10034 Flag indicates no secondary header in APID 

An error was detected when checking the secondary header flag within the APID data. This is 
most likely due to a corrupt APID file. 

-10035 Gap in APID sequence count 

A gap was detected in the APID sequence count. This most likely indicates missing data or a 
corrupt APID file. 

-10036 Mismatch in APID lengths 

A mismatch was detected when verifying the APID length field within the secondary header 
against the expected APID length, based on the file type of the APID. This is most likely due 
to a corrupt APID file. 

-10037 GPS Delta time exceeds limit 

The time between consecutive GPS updates exceeds a preset limit. This is most likely due to 
missing data. 

-10038 Inconsistent APID shot count 

The APID shot counts are inconsistent. This indicates that the APID alignment process may 
not work correctly. Contact the GSAS Development Team. 

-10039 Overflowed number of reserved header records 

This indicates the number of product header records has exceeded the expected number of 
product header records. The product header records may be incomplete. Contact the GSAS 
Development Team. 

-10040 Reference Orbit File is empty 

This indicates the reference orbit file is corrupt. 

-10041 Did not find desired rev in rev file 

This indicates that data time is not within the predicted orbit file. 

-10042 Granule time not within Ref Orb file 

This indicates that data time is not accounted for in the reference orbit id table. 

-10043 Undefined Segment type 

This indicates an error in routine while detennining segment type. 

-10044 Error running CreateGran util 

This indicates that the utility terminated abnormally. An error code will be generated where 
the error occurred. 
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-10045 Time error: current < previous 

This error indicates that time has moved backwards. This indicates a corrupt APID or product 
file. 

-10046 Error returned from script 

An error was returned from the SDMS met script. This is most likely due to a corrupt 
ANC40 file. 

-10047 File naming conventions do not match 

metutil has detected that the file naming conventions do not match when comparing the 
names of the ANC40 and ANC01 files. 

-10048 Unknown header keyword 

This indicates that the processing has detected a header keyword which was not expected. 
This may indicate lack of the appropriate input ANC45 file or a corrupted product file. 

-10049 APID record edited. Shot count > limit 

This indicates that a sanity check of the APID has detected a shot counter whose value is out 
of the nominal range (0-200). This normally indicates bad APID data. The APID record in 
question was removed from processing. 

-10050 GLA00 time/rec ndx inconsistency 

This indicates that an inconsistency was detected in the relationship between UTCtime and 
the unique record index. 

-10051 Control File Sanity Check Violation 

This indicates that a sanity-check rule was violated and the error is determined fatal. 

-10052 Shot cnt inconsistency between GFA00 and ANC29 

This indicates a potential corrupted ANC29. The shot counts do not match between corre- 
sponding records of GLA00 and ANC29. 

-10053 cksum does not match for GFA00 file 

This indicates that checksums recorded in ANC29 do not match those computed for the input 
GLA00. The ANC29 file and GLA00 data are mismatched. 

-10054 Output time inconsistency 

This indicates that inconsistency has been detected between the previous output time and the 
current output time. 

-10055 Control File Sanity Check Warning 

This indicates that a sanity-check rule was violated, but the error is not detennined fatal. 

-10056 Skipped EDOS-filled record 

This indicates that an input GLA00 record was skipped because of the corresponding EDOS 
fill flag. 

-10057 Cannot calculate NOSE info - E/E outside bounds 

This indicates that the current position is outside the expected NOSE range. 

-10058 Error processing NOSE info 

This indicates that an error occurred while processing NOSE information. 
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-10059 Error creating HDF-EOS swath (he5_swcreate) 

Not used. 

-10060 Error detaching HDF-EOS swath (he5_swdetach) 

Not used. 

-10061 Error in ANC45 metadata file 

This indicates that an inconsistency was detected between the input file headers and the 
ANC45 information. 

-10062 Error fdling HDF-EOS fde 

Not used. 

-10063 Unknown HDF-EOS data type 

Not used. 

D.1.1 LI A Errors 

-20001 Error reading PAD data Eng data 

No Used. 

-20002 Error reading PAD data Eng data 

Not Used. 

-20003 Background value out of range 

If background value is outside of threshold limits, lidar values are set to invalid and lidar qual- 
ity flag is set to 3. 

-20004 Energy value out of range 

If transmitted energy value is less than threshold value, lidar values are set to invalid. 

-20005 Large number bad lidar values within profile 

If the number of lidar values, within a profile, that fall outside of threshold limits exceeds a 
certain number, then the lidar values are set to invalid. 

-20006 APID not available - no atm processed 

Either the ancillary science packet data are unavailable or both the photon science packet and 
the cloud digitizer packet data are unavailable for the record. No LI A atmosphere data are 
processed and invalid values are written to GLA02. 

-20007 APID not available - atm processed 

Either the photon science packet data or the cloud digitizer packet data are unavailable for the 
record. Available L1A atmosphere data are processed. Unavailable values given invalid val- 
ues on GLA02. 

-20008 Range value out of range 

If range to start of profile value is outside of threshold limits, a default value is used. 

-20009 Attenuation setting <= 0, set to 1 

If the attenuation setting is less than 1 , it is set equal to 1 . 

-20010 1064 computed transmit energy unavailable 

If the 1064 nm transmitted energy is not available, a default value is used. 
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-20011 No ANC32 data available 

No ANC32 data are available for processing. Verify the correctness of the control file. 

-20012 No ANC33 data available 

No ANC33 data are available for processing. Verify the correctness of the control file. 

-20013 No ANC25 data available 

No ANC25 data are available for processing. Verify the correctness of the control file. 

-20014 Current number of seconds exceeds max number 

Not used. 

-20015 Using estimated shot time 

Shot time is being estimated instead of calculated. This is most likely due to a missing 
APID19 record. 

-20016 Filter number exceeds limit 

This indicates that the filter number in APID19 exceeds the physical number of filters. This 
indicates bad APID19 data. 

-20017 Time inconsistency 

This error indicates that the precise time computed in shot time mod differs from the esti- 
mated time computed using the MET counter by greater than one second. This could be due to 
bad data or bad ANC33/ANC25 entries. 

-20018 No LRS alignment for entire record 

This error indicates that an entire record of LRS data could not be aligned with the correct 
APID19. The LRS data are lost and were not written to GLA04. This error could be caused by 
missing APID19 data or a timing problem. 

-20019 No 1ST alignment for entire record 

This error indicates that an entire record of 1ST data could not be aligned with the correct 
APID19. The 1ST data are lost and were not written to GLA04. This error could be caused by 
missing APID19 data or a timing problem. 

-20020 No LRS alignment for shot 

This error indicates that a 1/10 second shot of LRS data could not be aligned with the correct 
APID19 shot. The LRS data are lost and were not written to GLA04. This error could be 
caused by missing AP1D19 data or a timing problem. 

-20021 No 1ST alignment for shot 

This error indicates that a 1/10 second shot of 1ST data could not be aligned with the correct 
APID19 shot. The 1ST data are lost and were not written to GLA04. This error could be 
caused by missing APID19 data or a timing problem. 

-20022 No LRS alignment for image 

This error indicates that an LRS image could not be aligned with the correct APID19 shot. 
The image data are lost and were not written to GLA04. This error could be caused by missing 
APID19 data or a timing problem. 
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-20023 Not enought SPCMs enabled 

One or no SPCMs are enabled. That is not enough to collect valid science data therefore no 
atmosphere processing is performed for this second. 

-20024 Exceeded max number of instrument states 

This indicates that the number of instrument changes exceeded a maximum value. 

-20025 Instrument State Changed 

This indicates that a change in instrument state was detected. 

-20026 Deleted 1ST frame 

This indicates that an 1ST frame was deleted by the realignment process. 

-20027 d cal c tx zero in C CalctNrg 

This indicates that the transmit energy for this shot is invalid. 

-20028 dcalcrec zero in CCalcrNrg 

This indicates that the received energy for this shot is invalid. 

-20029 Engineering Value above Yellow High Limit 

This indicates the engineering data is above the yellow high limit and the data associated with 
the time of the alarm is suspect for science use. 

-20030 Engineering Value below Yellow Low Limit 

This indicates the engineering data is below the yellow low limit and the data associated with 
the time of the alarm is suspect for science use. 

-20031 Engineering Value above Red High Limit 

This indicates the engineering data is above the red high limit and the data associated with the 
time of the alann is outside of engineering data specifications. 

-20032 Engineering Value below Red Low Limit 

This indicates the engineering data is below the red low limit and the data associated with the 
time of the alann is outside of engineering data specifications. 

-20033 Actual > Expected numrecs in QAP03 

The actual number of records read by QAP03 for the APID is more than expected; this is a 
warning. 

-20034 Reinitialized due to delta t > siru max diff 

This indicates that a synchronization reset occurred in the IST/LRS processing code. 

-20035 Incremented number of rolls 

This indicates that a rollover even was detected in the IST/LRS processing code. 

-20036 Swapping LRS VT2->VT0 

This indicates that within the LRS telemetry the virtual tracker 2 data was swapped with the 
virtual tracker 0 data and the ground processing unswapped the data. 

-20037 Swapping LRS VT1->VT0 

This indicates that within the LRS telemetry the virtual tracker 1 data was swapped with the 
virtual tracker 0 data and the ground processing unswapped the data. 
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-20038 Insufficient ANC32 records in file 

This indicates that time tagging failed because of an insufficient number of ANC32 records. 

D.2 Waveform Errors 

-30001 Singular Matrix 

Matrix inversion perfonned as part of the least squares fitting of a wavefonn to a Gaussian has 
yielded a singular matrix, and no solution is available. 

-30002 Number of peaks found greater than max 

The number of peaks found compounded within a single returned waveform exceeds the max 
number allowable. 

-30003 No signal 

Not used. 

-30004 Standard deviation is zero 

Not used. 

-30005 Bad Frame 

Not used. 

-30006 Error from C InterpPOD 

Not used. 

-30007 Error from C CalcSpLoc 

Not used. 

-30008 Error from WFMgr 

Filter number exceeds known values. It is less than 1 or greater than 6. Probable data error. 

-30009 W Estimates, Underflow creating DEXP values 

not used 

-30010 WFMgr, Inconsistent Compression Parameters. 

Compression parameters are inconsistent. Input parameters have not been defined consis- 
tently. Probable error in telemetry. 

-30011 GLA05_scal_mod, Overflow in sigma computation. 

This implies that the errors of the parameters solved for with the Gaussian fit are not within 
acceptable bounds. 

-30012 QAP file write error on Packet data 

Write error encountered while writing a record of 16-second processing packet data to the 
QAP file. Possible system-related error. 

-30013 QAP file write error on Summary data 

Write error encountered while writing a record of granule summary data to the QAP file. Pos- 
sible system-related error. 

-30014 W CalcReflct, Illegal value trans energy pulse. 

An unphysical value for the energy of the transmitted pulse exists, and is equal to or less than 
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0.0 joules. Reflectance is set to default to avoid division by zero and/or an unphysical compu- 
tation. 

-30015 GLA05_scal_mod, Overflow in reflectivity comp 

This implies that values used in the reflectivity calculation are outside bounds. 

-30016 WFMgrmod, Indeterminate waveform type 

Flag that identifies a waveform as short vs. long cannot be properly retrieved. Probable data 
error or missing data. 

-30017 WParamWithFit, dbgNoise/dsDevNoise invalid 
-30018 W ParamWithFit, dbgNoise/dsDevNoise invalid 

This indicates that an otherwise valid wavefonn has an invalid value for the observed noise 
and/or the standard deviation of the observed noise. 

-30019 WFMgr, anc33 file required 

Not used. 

-30020 WFMgr, Instrument State Invalid 

This indicates that the instrument state is invalid in C SetCalibVars. 

-30021 WFMgr, De-allocation error for QA arrays 

This indicates that there was an error during deallocation of the QA arrays. 

D.3 Atmosphere Errors 

Subsystem errors and corrective action will be fully documented in V2 of this document. 

-40001 DEM out-of-bounds 

If the DEM value is invalid or outside of threshold limits, do not process record. 

-40002 532 integrated return flag poor or bad 

If the 532 mn integrated return flag indicates that the 532 mn lidar data are poor, the 1 Hz 
backscatter quality flag is set to 1 . 

-40003 Ratio of integrated returns out-of-bounds 

If the ratio of the 532 mn integrated return / molecular integrated return is outside of threshold 
limits, then the 1 Hz backscatter quality flag is set to 1 . 

-40004 Large num bad recs not incl in data 

Not used. 

-40005 Excessive num bad recs not incl in data 

Not used. 

-40006 Time between recs greater than threshold 

Not used. 

-40007 Divide by zero 

If the denominator value is 0, set it to a default value. 
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-40008 Exponent too large 

If the exponent value exceeds a certain threshold limit, set the exponent to that limit. 

-40009 Index beyond gi cld lays 

Not used. 

-40010 Index beyond gipbaerlays 

Not used. 

-40011 Deficient 532 laser energy flag 

If the 532 nm energy laser flag indicates that the 532 nm transmitted laser energy is deficient, 
the 532 nm backscatter quality flag is set to 1. 

-40012 Deficient 1064 laser energy flag 

If the 1064 nm energy laser flag indicates that the 1064 nm transmitted laser energy is defi- 
cient, the 1064 nm backscatter quality flag is set to 1. 

-40013 Excess num cloudy recs not incl in data 

Not used. 

-40014 PBL signal ratio less than zero 

Not used. 

-40015 Input PBL height out-of-bounds 

If PBL height value is outside threshold limits, calculate PBL height as height of maximum 
profile signal. 

-40016 Aerosol signal ratio less than zero 

Not used. 

-40017 Insufficient filtered data for processing 

If the number of valid backscatter values averaged over a period of time is below a certain 
percentage, then data is not processed for that time span. This affects PBL and aerosol detec- 
tion. 

-40018 Random noise not valid for cloud detection 

If at least two backscatter values are not available to calculate a standard deviation, then the 
random noise is set to invalid. 

-40019 Too many bad locations 

This error is for met interpolation only. If the input latitude or longitude value is invalid, use 
last saved value. If the number of invalid values exceeds a threshold limit, this error is called. 

-40020 PBL QA array index beyond array size 

If the PBL height QA array is indexed by a number greater than the array dimension, no more 
data is added to the array. 

-40021 Invalid lat/lon from GLA07 

This error is for the atmosphere manager only. If control flags are set to skip POD processing 
and the latitude or longitude value from GLA07 is invalid, processing stops. 
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-40022 Invalid DEM from GLA07 

This error is for the atmosphere manager only. If control flags are set to skip POD processing 
and the DEM value from GLA07 is invalid, the DEM value is set to 0.0. 

-40023 Input product is not GLA02 

Not used. 

-40024 Invalid value written to ancillary file 

This error is for the atmosphere utility only. If a certain percentage of lidar values within a 
time segment are invalid, an invalid average is written to the anc36 file for the segment. This 
message may be seen often if there were clouds present when the data were collected. 

-40025 Array index is greater than size allowed 

If an array is indexed by a number greater than the array dimension, processing stops. Check 
the array dimension in the atmosphere constants file and increase if necessary. 

-40026 No ANC36 data for current granule 

If there is no ANC36 file for the current granule, then atmosphere backscatter processing 
stops. 

-40027 Cal cof avg is invalid after elim tests 

If the calibration coefficient is invalid after the elimination tests, use the original average 
taken before the tests and set the calibration coefficient quality flag to 2. 

-40028 ANC36 current granule data is in first structure 

ANC36 data for the current granule are expected in the second structure and data for the pre- 
vious granule are expected in the first structure. If data for the current granule are in the first 
structure, processing may continue, but data for the previous granule are not available. 

-40029 Matrix singularity in polynomial fit routine 

Not used. 

-40030 less than 3 cal constants for least sqrs fit 

Not used. 

-40031 GLAlOscalmod, Overflow in aerosol bs compute 

Values for GLA10%d_aer4_bs_prof and/or GLA10%d_cldl_bs_prof are not invalid, but they 
are also not within an acceptable and expected range of values and will result in an overflow 
of a conversion computation in the seal module. An atmospheric scientist should evaluate this 
data. 

-40032 GLAlO scal mod, Overflow in aerosol prof compute 

Values for GLA10%d_cldl_ext_prof and/or GLA10%d_aaer4_ext_prof are not invalid, but 
they are also not within an acceptable and expected range of values and will result in an over- 
flow of a conversion computation in the seal module. An atmospheric scientist should evalu- 
ate this data. 
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D.4 Elevation Errors 

-50001 Error reading met height file 

An error was detected reading the meteorological height file. This indicates a corrupt met 
height file. 

-50002 Error reading met temperature file 

An error was detected reading the meteorological temperature file. This indicates a corrupt 
met temperature file. 

-50003 Error reading met relative humidity file 

An error was detected reading the meteorological relative humidity file. This indicates a cor- 
rupt met relative humidity file. 

-50004 Error reading met precip water table file 

An error was detected reading the meteorological precip water file. This indicates a corrupt 
met precip water file. 

-50005 Elevation more than max pressure level ht 

The elevation is higher than the maximum pressure level height. This indicates elevation is 
suspect. 

-50006 Max Iterations exceeded in ODE calcs. 

This indicates that the data is suspect. 

-50007 Step size underflow in BS-step method 

This indicates that the data is suspect. 

-50008 Value of cosine GT 1.0 in Geoloc 

The cosine of angle is greater that 1 . Most probably due to round-off errors in calculation. 

-50009 Value of cosine LT -1.0 in Geoloc 

The cosine of angle is greater that 1 . Most probably due to round-off errors in calculation. 

-50010 Max Iterations exceeded in Geoloc 

This occurs when number of iterations exceeds preset limits. This indicates data is suspect. 

-50011 POD file structure is empty 

This occurs when POD file structure is not loaded from control file. Need to check if control 
file contains ANC08 or ANC20 input file. 

-50012 Time not within vals in POD file structure 

This occurs when data time is not within time range in the POD file structure. Need to check if 
correct start/stop times are entered in control file for the ANC08/ANC20 files. 

-50013 Error reading 10 consec recs in POD file 

This occurs when data time is past the last time in the ANC08/ANC20 file. 

-50014 Error reading Load Tide coeffs file 

An error was detected reading the load tide coefficients file. This indicates a corrupt load tide 
coefficients file. 
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-50015 Error reading Geoid coeffs file 

An error was detected reading the geoid file. This indicates a corrupt geoid file. 

-50016 Error reading DEM file 

An error was detected reading the DEM file. This indicates a corrupt DEM file. 

-50017 Error reading 1 deg Ocean Mask file 

An error was detected reading the ocean mask file. This indicates a corrupt ocean mask file. 

-50018 Size of ocean td array must be increased 

Error in legacy code. Need to refer to Richard Ray’s GOT00 documentation. 

-50019 Likely error in Checkl of legacy ocean td 

Error in legacy code. Need to refer to Richard Ray’s GOT00 documentation. 

-50020 Lat/Lon out of bounds in legacy ocean td 

Error in legacy code. Need to refer to Richard Ray’s GOT00 documentation. 

-50021 Increase dimensions in call to UTCSRI 

Error in legacy code. Need to refer to Richard Ray’s GOT00 documentation. 

-50022 Cannot take sq. root of negative quantity 

This indicates data is suspect. 

-50023 Bad Frame flag set in E SealceParm (rem) 

Not used. 

-50024 Bad Frame flag set in E LandParm (rem) 

Not used. 

-50025 Bad Frame flag set in E OceanParm (rem) 

Not used. 

-50026 Bad Frame flag set in E CalcSlope (rem) 

Not used. 

-50027 Bad Frame flag set in E CalcRange (rem) 

Not used. 

-50028 Geopotential Ht >max rel hum ht 

The geopotential height is more that the maximum height for relative humidity. The relative 
humidity is set to zero. 

-50029 ROT file structure is empty 

This occurs when ROT matrix file structure is not loaded from control file. Need to check if 
control file contains ANC24 input file. 

-50030 Time not within vals in ROT file structur 

This occurs when data time is not within time range in the ROT file structure. Need to check if 
correct start/stop times are entered in control file for the ANC24 files. 

-50031 Error reading recs in ROT file 

This indicates a corrupt ROT file. 
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-50032 Invalid input POD value in ccalcsploc 

This indicates that data could not be geolocated because the POD value is invalid. 

-50033 Error reading fine Surface Type file 

An error has occurred reading the ANC27_00 file. This indicates a corrupt 2min x 2min 
ANC27 file. 

-50034 Error reading coarse Surface Type file 

An error has occurred reading the ANC27_01 file. This indicates a corrupt ldeg x ldeg 
ANC27 file. 

-50035 LAT/LON out of bounds in coarse surf type 

The latitude/longitude is not within the lat/lon boundaries. This indicates that data is suspect. 

-50036 LAT/LON out of bounds in fine surf type 

The latitude/longitude is not within the lat/lon boundaries. This indicates that data is suspect. 

-50037 Fine surface type grid index out of bounds 

This indicates that data is suspect. 

-50038 Unreasonable values for POD degradation 

This indicates that input values of orbit degradation and/or supplemental descriptive informa- 
tion obtained from the header of the orbit file are not valid values. This could indicate the 
wrong file, a corrupted file, or bad parameters entered when the file was created. Consult the 
originator of the file for an explanation of the problem. 

-50039 Unreasonable values for PAD degradation 

This indicates that input values of attitude degradation and/or supplemental descriptive infor- 
mation obtained from the header of the attitude file are not valid values. This could indicate 
the wrong file, a corrupted file, or bad parameters entered when the file was created. Consult 
the originator of the file for an explanation of the problem. 

-50040 l_WFqual(gwi_noFit2,:) not properly set 

Not used. 

-50041 Reading ANC04 header rec instead of data rec 

Not used. 

-50042 ANC04 GPSMJD not eq to data MJD 

Not used. 

-50043 Read Error on Track Record 

This indicates that SRTM track file had a read error, possibly caused by its absence in the con- 
trol file. 

-50044 superceeded 

Not used. 

-50045 Time Exceeds Bounds of Reference Orbit Track 

This indicates that a time outside the recognized bounds of an SRTM track file was used when 
trying to access the track file. 


March 2013 


Page D-15 


Version 7.0 



The GLAS Science Algorithm Software (GSAS) User’s Guide 


GSAS Error and Status Codes 


-50046 Attempt to update QA with invalid data 

Not used. 

-50047 Error reading anc52xx file 

This indicates that there was an I/O error during the reading of an anc52xx file, or that neces- 
sary infonnation was missing from the header. 

-50048 Pass Data Not Available When Seeking Track Number 

This indicates that pass infonnation containing the track number was unavailable to be 
matched to a read of an SRTM track file, where track number matching is required before data 
can be accessed. 

D.5 HP Runtime Error Codes 

This section provides a list of HP runtime error codes. These codes are taken directly from HP 
Fortran 90 Programmers Reference; Product Number: B3909DB; Fortran 90 Compiler for 
HP-UX; Document Number: B3908-90002; October 1998. 


Error No. 

Error Message 

Description 

Action 

900 

ERROR IN FORMAT 

FORMAT statement syntax 
contains an error. 

Refer to the syntax for 
“FORMAT” on page 330. 
Also see Chapter 8, “I/O 
and file handling,” on 
page 171 for the syntax 
of the format specification 
and edit descriptors. 

901 

NEGATIVE UNIT 
NUMBER SPECIFIED 

Unit number was not greater 
than or equal to zero. 

Use a non-negative unit 
number. 

902 

FORMATTED I/O 
ATTEMPTED ON 
UNFORMATTED 
FILE 

Formatted I/O was attempted 
on a file opened for unformat- 
ted I/O. 

Open the file for format- 
ted I/O or perform unfor- 
matted I/O on this file. 9 

903 

UNFORMATTED I/O 
ATTEMPTED ON 
FORMATTED FILE 

Unformatted I/O was 
attempted on a file opened for 
formatted I/O. 

Open the file for unfor- 
matted I/O or perform for- 
matted I/O on this file. 

904 

DIRECT I/O 
ATTEMPTED ON 
SEQUENTIAL FILE 

Direct operation attempted on 
sequential file, direct operation 
attempted on opened file con- 
nected to a terminal. 

Use sequential opera- 
tions on this file, open file 
for direct access, or do 
not do direct I/O on a file 
connected to a terminal. 

905 

ERROR IN LIST- 
DIRECTED READ OF 
LOGICAL DATA 

Found repeat value, but no 
asterisk. First character after 
optional decimal point was not 
T or F. 

Change input data to cor- 
respond to syntax 
expected by list-directed 
input of logicals, or use 
input statement that cor- 
responds to syntax of 
input data. 


Version 7.0 


Page D-16 


March 2013 






GSAS Error and Status Codes 


The GLAS Science Algorithm Software (GSAS) Us- 


Error No. 

Error Message 

Description 

Action 

907 

ERROR IN LIST- 
DIRECTED READ OF 
CHARACTER DATA 

Found repeat value, but no 
asterisk. Characters not delim- 
ited by quotation marks. 

Change input data to cor- 
respond to syntax 
expected by list-directed 
input of characters, or 
use input statement that 
corresponds to syntax of 
input data. 

908 

COULD NOT OPEN 
FILE SPECIFIED 

Tried to open a file that the 
system would not allow for one 
of the following reasons: 
access to the file was denied 
by the file system due to 
access restriction; the named 
file does not exist; or the type 
of access request is impossi- 
ble. 

Correct the pathname to 
open the intended file. 

909 

SEQUENTIAL I/O 
ATTEMPTED ON 
DIRECT ACCESS 
FILE 

Attempted a BACKSPACE, 
REWIND, or ENDFILE on a 
terminal or other device for 
which these operations are not 
defined. 

Do not use the BACK- 
SPACE, REWIND, and 
ENDFILE statements. 

910 

ACCESS PAST END 
OF RECORD 
ATTEMPTED 

Tried to do I/O on record of a 
file past beginning or end of 
record. 

Perform I/O operation 
within bounds of the 
record, or increase 
record length. 

912 

ERROR IN LIST I/O 
READ OF COMPLEX 
DATA 

While reading complex data, 
one of the following problems 
has occurred: no left parenthe- 
sis and no repeat value; repeat 
value was found but no aster- 
isk; or no closing right paren- 
thesis. 

Change input data to cor- 
respond to syntax 
expected by list-directed 
input of complex num- 
bers, or use input state- 
ment corresponding to 
syntax of input data. 

913 

OUT OF FREE 
SPACE 

Library cannot allocate an I/O 
block (from an OPEN state- 
ment), parse array (for formats 
assembled at run-time), file 
name string (from OPEN) 
characters from list-directed 
read, or file buffer. The pro- 
gram may be trying to over- 
write a shared memory 
segment defined by another 
process. 

Allocate more free space 
in the heap area, open 
fewer files, use FORMAT 
statements in place of 
assembling formats at 
run time in character 
arrays, or reduce the 
maximum size of file 
records. 
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914 

ACCESS OF 
UNCONNECTED 
UNIT ATTEMPTED 

Unit specified in I/O statement 
has not previously been con- 
nected to anything. 

Connect unit using the 
OPEN statement before 
attempting I/O on it, or 
perform I/O on another, 
already connected, unit. 

915 

READ UNEXPECTED 
CHARACTER 

Read a character that is not 
admissible for the type of con- 
version being performed. Input 
value was too large for the 
type of the variable. 

Remove from input data 
any characters that are 
illegal in integers or real 
numbers. 

916 

ERROR IN READ OF 
LOGICAL DATA 

An illegal character was read 
when logical data was 
expected. 

Change input data to cor- 
respond to syntax 
expected when reading 
logical data or use input 
statement corresponding 
to syntax of input data. 

917 

OPEN WITH NAMED 
SCRATCH FILE 
ATTEMPTED 

Executed OPEN statement 
with STATUS='SCRATCH', but 
also named the file. Scratch 
files must not be named. 

Either remove the FILE= 
specifier, or open the file 
with a status other than 
STATUS-SCRATCH’. 

918 

OPEN OF EXISTING 
FILE WITH STA- 
TUS-NEW' 
ATTEMPTED 

Executed OPEN statement 
with STATUS='NEW', but file 
already exists. 

Either remove the STA- 
TUS= specifier from the 
OPEN statement, or use 
the STATUS='OLD'; STA- 
TUS-UNKNOWN’; or 
STATUS- REPLACE’ 
specifier. 

920 

OPEN OF FILE CON- 
NECTED TO DIF- 
FERENT UNIT 
ATTEMPTED 

You attempted to open a file 
that is already open with a dif- 
ferent unit number. 

Close the file with the 
current unit number 
before attempting to open 
it with a different unit 
number. 

921 

UNFORMATTED 
OPEN WITH BLANK 
SPECIFIER 
ATTEMPTED 

OPEN statement specified 
FORM-UNFORMATTE D' 
and BLANK=xx. 

Either use FORM-FOR- 
MATTED’ or remove 
BLANK=xx. 

922 

READ ON ILLEGAL 

RECORD 

ATTEMPTED 

Attempted to read a record of 
a formatted or unformatted 
direct file that is beyond the 
current end-of-file. 

Read records that are 
within the bounds of the 
file. 

923 

OPEN WITH ILLE- 
GAL FORM SPECI- 
FIER ATTEMPTED 

FORM= specified string other 
than 'FORMATTED' or 
’UNFORMATTED’. 

Use either 'FORMATTED' 
or 'UNFORMATTED' for 
the FORM= specifier in 
an OPEN statement. 
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924 

CLOSE OF 
SCRATCH FILE 
WITH STA- 
TUS-KEEP' 
ATTEMPTED 

The file specified in the 
CLOSE statement was previ- 
ously opened with 'SCRATCH' 
specified in the STATUS= 
specifier. 

Open the file with a STA- 
TUS= , specifying a string 
other than 'SCRATCH' or 
do not specify STA- 
TUS-KEEP' in the 
CLOSE statement for this 
scratch file. 

925 

OPEN WITH ILLE- 
GAL STATUS SPECI- 
FIER ATTEMPTED 

STATUS^ specified string 
other than 'OLD' 'NEW' 
'UNKNOWN' 'REPLACE' or 
'SCRATCH'. 

Use 'OLD', 'NEW', 
'UNKNOWN', 'REPLACE' 
or 'SCRATCH' for the 
STATUS^ specifier in 
OPEN statement. 

926 

CLOSE WITH ILLE- 
GAL STATUS SPECI- 
FIER ATTEMPTED 

STATUS^ specified string 
other than ’KEEP' or 
'DELETE'. 

Use 'KEEP' or 'DELETE' 
for the STATUS^ speci- 
fier in a CLOSE state- 
ment. 

927 

OPEN WITH ILLE- 
GAL ACCESS SPEC- 
IFIER ATTEMPTED 

ACCESS^ specified string 
other than 'SEQUENTIAL' or 
'DIRECT'. 

Use 'SEQUENTIAL' or 
'DIRECT' for the 
ACCESS= specifier in an 
OPEN statement. 

929 

OPEN OF DIRECT 
FILE WITH NO RECL 
SPECIFIER 
ATTEMPTED 

OPEN statement has 
ACCESS-DIRECT', but no 
RECL= specifier. 

Add RECL= specifier to 
OPEN statement, or 
specify ACCESS^ 
'SEQUENTIAL'. 

930 

OPEN WITH RECL 
LESS THAN 1 
ATTEMPTED 

RECL= specifier in OPEN 
statement was less than or 
equal to zero. 

Specify a positive number 
for RECL= specifier in 
OPEN statement. 

931 

OPEN WITH ILLE- 
GAL BLANK SPECI- 
FIER ATTEMPTED 

BLANK= specified string other 
than 'NULL' or 'ZERO' 

Use 'NULL' or 'ZERO' for 
BLANK= specifier in 
OPEN statement. 

933 

END (OR BEGIN) OF 
FILE WITH NO 
END=x SPECIFIER 

End-of-file mark read by a 
READ statement with no 
END= specifier to indicate 
label to which to jump. 

Use the END= specifier 
to handle EOF, or check 
logic. 

937 

ILLEGAL RECORD 
NUMBER SPECIFIED 

A record number less than one 
was specified for direct I/O. 

Use record numbers 
greater than zero. 

942 

ERROR IN LIST- 
DIRECTED READ - 
CHARACTER DATA 
READ FOR ASSIGN- 
MENT TO NON- 
CHARACTER 
VARIABLE 

A character string was read for 
a numerical or logical variable. 

Check input data and 
input variable type. 
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944 

RECORD TOO LONG 
IN DIRECT UNFOR- 
MATTED I/O 

Output requested is too long 
for specified (or pre- existing) 
record length. 

Make the number of 
bytes output by WRITE 
less than or equal to the 
file record size. 

945 

ERROR IN FORMAT- 
TED I/O 

More bytes of I/O were 
requested than exist in the cur- 
rent record. 

Match the format to the 
data record. 

953 

NO REPEATABLE 
EDIT DESCRIPTOR 
IN FORMAT STRING 

No format descriptor was 
found to match I/O list items. 

Add at least one repeat- 
able edit descriptor to the 
format statement. 

956 

FILE SYSTEM 
ERROR 

The file system returned an 
error status during an I/O oper- 
ation. 

See the associated file 
system error message. 

957 

FORMAT DESCRIP- 
TOR INCOMPATI- 
BLE WITH NUMERIC 
ITEM IN I/O LIST 

A numeric item in the I/O list 
was matched with a non- 
numeric edit descriptor. 

Match format descriptors 
to I/O list. 

958 

FORMAT DESCRIP- 
TOR INCOMPATI- 
BLE WITH 
CHARACTER ITEM 
IN I/O LIST 

A character item in the 1/ 0 list 
was matched with an edit 
descriptor other than A or R. 

Match format descriptors 
to I/O list. 

959 

FORMAT DESCRIP- 
TOR INCOMPATI- 
BLE WITH LOGICAL 
ITEM IN I/O LIST 

A logical item in the I/O list 
was matched with a edit 
descriptor other than L. 

Match format descriptors 
to I/O list. 

973 

RECORD LENGTH 
DIFFERENT IN SUB- 
SEQUENT OPEN 

Record length specified in sec- 
ond OPEN conflicted with the 
value as opened. 

Only BLANK=, DELIM=, 
and PAD= specifiers may 
be changed by a redun- 
dant OPEN. 

974 

RECORD 
ACCESSED PAST 
END OF INTERNAL 
FILE RECORD 
(VARIABLE) 

An attempt was made to trans- 
fer more characters than inter- 
nal file length. 

Match READ or WRITE 
statement with internal 
file size. 

975 

ILLEGAL NEW FILE 
NUMBER 
REQUESTED IN 
FSET FUNCTION 

The file number requested to 
be set was not a legal file sys- 
tem file number. 

Check that the OPEN 
succeeded and the file 
number is correct. 

976 

UNEXPECTED 
CHARACTER IN 
’’NAMELIST” READ 

An illegal character was found 
in namelist-directed input. 

Be sure input data con- 
forms to the syntax rules 
for namelist-directed 
input, or remove illegal 
character from data. 
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977 

ILLEGAL SUB- 
SCRIPT OR SUB- 
STRING 

IN”NAMELIST” READ 

An invalid subscript or sub- 
string specifier was found in 
namelist-directed input. Possi- 
ble causes include bad syntax, 
subscript/substring compo- 
nent out-of- bounds, wrong 
number of subscripts and sub- 
string on non-character vari- 
able. 

Check input data for syn- 
tax errors. Be sure sub- 
script/substring specifiers 
are correct for data type. 
Specify only array ele- 
ments within the bounds 
of the array being read. 

978 

TOO MANY VALUES 
IN “NAMELIST” 
READ 

Too many input values were 
found during a namelist- 
directed READ. This message 
will be generated by attempts 
to fill variables beyond their 
memory limits. 

Supply only as many val- 
ues as the length of the 
array. 

979 

VARIABLE NOT IN 
NAMELIST GROUP 

A variable name was encoun- 
tered in the input stream that 
was not declared as part of the 
current namelist group. 

Read only the variables 
in this namelist. 

980 

NAMELIST I/O 
ATTEMPTED ON 
UNFORMATTED 
FILE 

An illegal namelist-directed I/O 
operation was attempted on an 
unformatted (binary) file. 

Specify FORM- FOR- 
MATTED' in OPEN state- 
ment, or use namelist- 
directed I/O only on for- 
matted files. 

1010 

OPEN WITH ILLE- 
GAL PAD SPECIFIER 
ATTEMPTED 

An attempt was made to open 
a file with an illegal value spec- 
ified for the PAD= specifier. 

Specify either PAD='YES' 
or PAD-NO'. 

1011 

OPEN WITH ILLE- 
GAL POSITION 
SPECIFIER 
ATTEMPTED 

An attempt was made to open 
a file with an illegal value spec- 
ified for the POSITION^ speci- 
fier. 

Specify POSI- 
TION='ASIS', POSI- 
TION-REWIND' or 
POSITION='APPEND'. 

1012 

OPEN WITH ILLE- 
GAL DELIM SPECI- 
FIER ATTEMPTED 

An attempt was made to open 
a file with an illegal value spec- 
ified for the DELIM= specifier. 

Specify DELIM= 'APOS- 
TROPHE', 
DELIM='QUOTE'or 
DELIM- NONE'. 

1013 

OPEN WITH ILLE- 
GAL ACTION SPECI- 
FIER ATTEMPTED 

An attempt was made to open 
a file with an illegal value spec- 
ified for the ACTION= speci- 
fier. 

Specify ACTION='READ', 
ACTION='WRITE' or 
ACTION-READWRITE'. 
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Abbreviations & Acronyms 


A2P 

ALT 

ANCxx 

APID 

ATBD 

ATM 

CCB 

ClearCase 

CR 

DAAC 

DEM 

DFD 

DLT 

EDOS 

EDS 

ELEV 

EOC 

EOS 

EOSDIS 

GB 

GDS 

GLAS 

GLAxx 

GLOP 

GPS 

GSAS 

GSFC 

GSFC/WFF 


Algorithm-to-Product Conversion 

Altimeter or Altimetry, also designation for the EOS-Altimeter spacecraft series 

GLAS Ancillary Data Files 

GLAS Level-0 Data file 

Algorithm Theoretical Basis Document 

Atmosphere 

Change Control Board 

GSAS version tracking software 

Change Request 

Distributed Active Archive Center 

Digital Elevation Model 

Data Flow Diagram 

Digital Linear Tape 

EOS Data and Operations System 

Expedited Data Set 

Elevation 

EOS Operating Center 

NASA Earth Observing System Mission Program 
Earth Observing System Data and Information System 
Gigabyte 

GLAS Ground Data System 

Geoscience Laser Altimeter System instrument or investigation 

GLAS Science Data Product Files 

GLAS Level-0 PGE (correctly called GLAS_LOproc) 

Global Positioning System 
GLAS Science Algorithm Software 

NASA Goddard Space Flight Center at Greenbelt, Maryland 

NASA Goddard Space Flight Center/Wallops Flight Facility at Wallops Island, 
Virginia 
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HDF 

Hierarchical Data Format 

HDF-EOS 

EOS-specific Hierarchical Data Format 

l-SIPS 

Icesat Science Investigator Led Processing System 

I/O 

Input/Output 

ICESAT 

Ice, Cloud and Land Elevation Satellite 

ID 

Identification 

IDL 

Interactive Data Language 

IEEE 

Institute for Electronics and Electrical Engineering 

ISF 

Instrument Support Facility 

1ST 

Instrument Star Tracker 

KB 

Kilobyte 

L0 

Level 0 

L1A 

Level-IA 

LIB 

Level-1 B 

L2 

Level-2 

LASER 

Light Amplification by Stimulated Emission of Radiation 

LIDAR 

Light Detection and Ranging 

LPA 

Laser Pointing Array 

LRS 

Laser Reference System 

MB 

Megabyte 

MET 

(context sensitive) Mission Elapsed Time or Meteorological 

MOSS 

Mission Operations Science Simulation (test) 

N/A or NA 

Not (/) Applicable 

NASA 

National Aeronautics and Space Administration 

NOAA 

National Oceanic and Atmospheric Administration 

P2A 

Product-to-Algorithm Conversion 

PAD 

Precision Attitude Determination 

PDF 

Portable Document Format 

PDS 

Production Data Set 

PGE 

Product Generation Executable 

POD 

Precision Orbit Determination 

PR 

Problem Report 
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QA 

Quality Assessment 

QAP 

Quality Assessment Processing 

SC 

Structure Chart 

SCF 

Science Computing Facility 

SDMP 

Science Data Management Plan 

SDMS 

Scheduling and Data Management System 

SDP 

Standard Data Products 

SRS 

Stellar Reference System 

SSMP 

Science Software Management Plan 

SSRF 

Science Software Requirements Document 

TBD 

to be determined, to be done, or to be developed 

UNIX 

the operating system jointly developed by the AT&T Bell Laboratories and the 
University of California-Berkeley System Division 

UTC 

Universal Time Correlation 

WF 

Waveform 
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Glossary 


aggregate 


array 


file 


header 


item 


label 


Level 0 


Level 1A 


A collection, assemblage, or grouping of distinct data parts together to make a 
whole. It is generally used to indicate the grouping of GLAS data items, 
arrays, elements, and EOS parameters into a data record. For example, the 
collection of Level IB EOS Data Parameters gathered to form a one-second 
Level 1 B data record. It could be used to represent groupings of various 
GLAS data entities such as data items aggregated as an array, data items and 
arrays aggregated into a GLAS Data Element, GLAS Data Elements aggre- 
gated as an EOS Data Parameter, or EOS Data Parameters aggregated into a 
Data Product record. 

An ordered arrangement of homogenous data items that may either be syn- 
chronous or asynchronous. An array of data items usually implies the ability to 
access individual data items or members of the array by an index. An array of 
GLAS data items might represent the three coordinates of a georeference 
location, a collection of values at a rate, ora collection of values describing an 
altimeter waveform. 

A collection of data stored as records and terminated by a physical or logical 
end-of-file (EOF) marker. The term usually applies to the collection within a 
storage device or storage media such as a disk file or a tape file. Loosely 
employed it is used to indicate a collection of GLAS data records without a 
standard label. For the Level 1A Data Product, the file would constitute the 
collection of one-second Level 1A data records generated in the SDPS work- 
ing storage for a single pass. 

A text and/or binary label or information record, record set, or block, prefacing 
a data record, record set, or a file. A header usually contains identifying or 
descriptive information, and may sometimes be embedded within a record 
rather than attached as a prefix. 

Specifically, a data item. A discrete, non-decomposable unit of data, usually a 
single word or value in a data record, or a single value from a data array. The 
representation of a single GLAS data value within a data array or a GLAS Data 
Element. 

The text and/or binary information records, record set, block, header, or head- 
ers prefacing a data file or linked to a data file sufficient to form a labeled data 
product. A standard label may imply a standard data product. A label may 
consist of a single header as well as multiple headers and markers depending 
on the defining authority. 

The level designation applied to an EOS data product that consists of raw 
instrument data, recorded at the original resolution, in time order, with any 
duplicate or redundant data packets removed. 

The level designation applied to an EOS data product that consists of recon- 
structed, unprocessed Level 0 instrument data, recorded at the full resolution 
with time referenced data records, in time order. The data are annotated with 
ancillary information including radiometric and geometric calibration coeffi- 
cients, and georeferencing parameter data (i.e. , ephemeris data). The 
included, computed coefficients and parameter data have not however been 
applied to correct the Level 0 instrument data contents. 
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Level IB 


Level 2 


Level 3 


Level 4 


metadata 


orbit 


model 

module 


parameter 


pass 


PDL 


process 


The level designation applied to an EOS data product that consists of Level 1 A 
data that have been radiometrically corrected, processed from raw data into 
sensor data units, and have been geolocated according to applied georefer- 
encing data. 

The level designation applied to an EOS data product that consists of derived 
geophysical data values, recorded at the same resolution, time order, and geo- 
reference location as the Level 1A or Level IB data. 

The level designation applied to an EOS data product that consists of geo- 
physical data values derived from Level 1 or Level 2 data, recorded at a tem- 
porally or spatially resampled resolution. 

The level designation applied to an EOS data product that consists of data 
from modeled output or resultant analysis of lower level data that are not 
directly derived by the GLAS instrument and supplemental sensors. 

The textual information supplied as supplemental, descriptive information to a 
data product. It may consist of fixed or variable length records of ASCII data 
describing files, records, parameters, elements, items, formats, etc., that may 
serve as catalog, data base, keyword/value, header, or label data. This data 
may be parsable and searchable by some tool or utility program. 

The passage of time and spacecraft travel signifying a complete journey 
around a celestial or terrestrial body. For GLAS and the EOS ALT-L spacecraft 
each orbit starts at the time when the spacecraft is on the equator traveling 
toward the North Pole, continues through the equator crossing as the space- 
craft ground track moves toward the South Pole, and terminates when the 
spacecraft has reached the equator moving northward from the South Polar 
region. 

A graphical representation of a system. 

A collection of program statements with four basic attributes: input and output, 
function, mechanics and internal data. 

Specifically, an EOS Data Parameter. This is a defining, controlling, or con- 
straining data unit associated with a EOS science community approved algo- 
rithm. It is identified by an EOS Parameter Number and Parameter Name. An 
EOS Data Parameter within the GLAS Data Product is composed of one or 
more GLAS Data Elements 

A sub-segment of an orbit, it may consist of the ascending or descending por- 
tion of an orbit (e.g., a descending pass would consist of the ground track seg- 
ment beginning with the northernmost point of travel through the following 
southernmost point of travel), or the segment above or below the equator; for 
GLAS the pass is identified as either the northern or southern hemisphere por- 
tion of the ground track on any orbit 

Program Design Language (Pseudocode). A language tool used for module 
programming and specification. It is at a higher level than any existing compil- 
able language. 

An activity on a dataflow diagram that transforms input data flow(s) into output 
data flow(s). 
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product 


program 

record 

Scenario 

Standard Data 
Product 


State Transition 
Diagram 

Stub 

Structured Chart 

Structured Design 

Subroutine 

variable 


Specifically, the Data Product or the EOS Data Product. This is implicitly the 
labeled data product or the data product as produced by software on the 
SDPS or SCF. A GLAS data product refers to the data file or record collection 
either prefaced with a product label or standard formatted data label or linked 
to a product label or standard formatted data label file. Loosely used, it may 
indicate a single pass file aggregation, or the entire set of product files con- 
tained in a data repository. 

The smallest set of computer instructions that can be executed as a stand- 
alone unit 

A specific organization or aggregate of data items. It represents the collection 
of EOS Data Parameters within a given time interval, such as a one-second 
data record. It is the first level decomposition of a product file. 

A single execution path for a process. 

Specifically, a GLAS Standard Data Product. It represents an EOS ALT-L/ 
GLAS Data Product produced on the EOSDIS SDPS for GLAS data product 
generation or within the GLAS Science Computing Facility using EOS science 
community approved algorithms. It is routinely produced and is intended to be 
archived in the EOSDIS data repository for EOS user community-wide access 
and retrieval. 

Graphical representation of one or more scenarios. 


(alias dummy module) a primitive implementation of a subordinate module, 
which is normally used in the top-down testing of superordinate (higher) mod- 
ules. 

A graphical tool for depicting the partitioning of a system into modules, the 
hierarchy and organization of those modules, and the communication inter- 
faces between the modules. 

The development of a blueprint of a computer system solution to a problem, 
having the same components and interrelationships amount the components 
as the original problem has. 

A program that is called by another program 

Usually a reference in a computer program to a storage location, i.e. , a place 
to contain or hold the value of a data item. 
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